. 
i 


— PMN S,498, S7IOZESWL 


T™MS320C25 


User’s Guide 


Preliminary 


Digital Signal Processor 


Products 


- 


TEXAS 
INSTRUMENTS 


TMS320C25 
User’s Guide 


Digital Signal Processor Products 


Preliminary 


IMPORTANT NOTICE 


Texas Instruments (Tl) reserves the right to make changes in the 
devices or the device specifications identified in this publication 
without notice. Tl advises its customers to obtain the latest version 
of device specifications to verify, before placing orders, that the 
information being relied upon by the customer is current. 


In the absence of written agreement to the contrary, Tl assumes no 
liability for Tl applications assistance, customer's product design, 
or infringement of patents or copyrights of third parties by or arising 
from use of semiconductor devices described herein. Nor does Tl 
warrant or represent that any license, either express or implied, is 
granted under any patent right, copyright, or other intellectual 
property right of TI covering or relating to any combination, machine, 
Or process in which such semiconductor devices might be or are 
used. 


Copyright © 1986, Texas Instruments Incorporated 


Contents 


Section 

1 Introduction 

Tt Sa ERTD  ck ook eG i een ee pe ws ee eo ee ee 
tie. eee ee a a a a Oe oe es ee eee eee 
aa Se a a os a ae oe i ee 6 SB re 
Tt How To Use Thie Manual: «6k ce i ee we ee PE BESO. ROR 
TR FIGPOYRIIGOG © ~. ae te tw at ew tt oat PO BEES ODA Sener. 
2 Architectural Overview 

eee er ee a i a od le oe pe ee ee eee. 
2.2 inet GN Signe. OSSeCtiOnNS © «2 re oes SPY HOUSE Mer (SUOMI 
ream iter ft ia GOR ge. gx. ae De hee as a ee Ee a ee as ee 
aen Corral Arithmetic Logie nit (CALU)  .. 6. ne tee es Ree eres 
mee I I ki fe ee Ke le es eS ow pee ea dae 
ee A go kk ye ee We a tee ee By ee 2 a 8 a Pee oe 
ie rea A Soe PI eck ea cok ee ee be a ea we ak ee eee 
A. Pereseine naeges and instructions $6. 6s ee ee ee Ram ee ees 
eat AOE I a So aS we LW Soe dew be doe eee a es 


OHAONS WRF YHTRONS 


N= RON 


W WD WO WW) WW WW WW WW WW) W WW WW WW WW W WW WW WW W WW W 
ONNNNNMOMODOTHOHOHOPRRARARWWWWHNNNNNNN—= 
WN - 


Device Operation 
Internal Hardware Summary 
Memory Organization 
On-Chip Program ROM 
On-Chip Data RAM Blocks 
Memory Maps 
Memory-Mapped Registers 
Auxiliary Registers 
Addressing Modes 
Memory-to-Memory Moves 
Central Arithmetic Logic Unit (CALU) 
Scaling Shifter 
ALU and Accumulator 
Multiplier, T and P Registers 
System Control 
Program Counter and Related Hardware 
Reset 
Status Registers 
Timer Operation 
Repeat Counter 
Powerdown Mode 
External Memory and |/O Interface 
Memory Combinations 
Internal Clock Timing Relationships 
External Read Cycle 
External Write Cycle 
Interrupts 
Interrupt Operation 
External Interrupt Interface 
Serial Port 
Burst- Mode Operation 


Continuous-Mode Operation Using Frame Sync Pulses 
Continuous-Mode Operation Without Frame Sync Pulses 
Initialization of Continuous-Mode Operation Without Frame Sync Pulses 


Multiprocessing and Direct Memory Access (DMA) 


3.8.1 Se et a's” ee a ee ee tk ene Sr a 
a0. <Gieee Cheer. ww co. ee i ce we ee See ee 89 
ek Oe Ce REN Ge a a> yea eee pe wo Sak ee hem a 
BD GO FU a ee Se Bw Se ee ew 
3.9.1 ne a cope A ge ee ee ee Se wn eee, a ee 
3.9.2 External Flag Output Peabo gi tie ee eee aL ee AP Be a ee Ee a 


4 Assembly Language Instructions 


ay. a ew a ew es | ek a 8% Beebe ede tea 
4.1.1 DieGt Perens On Gs ec eal we pees bg DS See eRe 
4.1.2 niciivect Acrenerig de. gg i ae cal Sk we ee eats 2abb Se tae 
4.1.3 lmmediate AGGMSsNG WOde © ok ee ee et ee a ie os BRS 
ee I i pr ee a cae cate hy og Wa ac ae aw Phe RSA DOS) Ske wT Oe | 
4.2.1 Sas BE OTE a oe i OR ae A oo ee ee Sel ee 
4.2.2 freetrineien GOl erent ay ee ee Fle Cs See wee pyar ea 
4-4— -indiwidwur mevuction Tiescrotions 5. wk oe les ae eenne Mao nbs pce 


5 Software Applications 


et ea a se a So a oo ae sl a ee Se ce ey oe eae 
tae ne RE Po oe a oe ee a ee eae gee oa Eee ete 
5.2.1 Ret ee aes is Se a se Se a ee ee ee a ee oe 
ogee” ae MIEN Sg ss a> oN Se Se a ws £5 ae Ie geen es ee aa 
ae. is Se ng a Ro eee WIR oe ee MR oe ee 
5.2.4 Ceara aC ETE LAR ea ams 4 Ge re ae RE Oy ie Ee hs 
Seek: < Aue Se eS EE ae Se a ee ee er 
Ga ~ ere Ce eine a eS 6 oe al oe ee ee oe ae 
5.3.1 Context Switching Mig Sw aE a Fs eal 1 3 Re eee i 
S32 ihterruot Priornty.. .. . =... . os Shite Goa? ee, ew a Tee ae, gS a eee 
Bac Wier eneenat, ck ce a ae as Bl LM Oe eee aoe 
5.4.1 ek i ee eR ee a eal bv eee Melee areal 
Bas -Gontiguring On-Chip RAM ©. fee iS. wile eee oe si eA. 


5.4.3 Using On-Chip RAM for Program Execution 
5.5 Fundamental Logical and Arithmetic Operations 
5.5.1 Status Register Effect on Data Processing 


5:.6:2 Bit: Maninulstion.- - ee we we 
5.6 Advanced Arithmetic Operations ...... 
5.6.1 Overflow Management.......... 
5.6.2 enn ene Si a ee OE ee 
5.6,3 peers SS a eee ae ee 8 
5.6.4 PRU es ee ee ee ee 
5:65 DRI Noord ct Senay ay ga ERE: Bh 
5.6.6 Floating-Point Arithmetic ........ 
6.6:7 Indexed Addressing ........... 
5.6.8 Extended-Precision Arithmetic ...... 
5.7 Application-Oriented Operations ...... 
o 724 RITES Se Fre ae eee 
5.7.2 PRIME oo le PO ee OR ee 
5.7.3 Fast Fourier Transforms (FFT) ...... 


6 Hardware Applications 


6.1 External Local Memory Interface ...... 
eee en IO a ee eo ee ee en ae 
6.3. Direct Memory Access ............ 
S:4: Global: Memory... 6 ow PRINT SRS O88 
6:5- Codec interface 22° Se VCS NST? 84 
eo 0 PONG a Pee eo er oe eS 


; hn ale ati a Oe ae a 
—“~ OMA ONIWNN = 


1 
os 


O1 O1 O1 O1 O1 OI OI 
CON OPAN = 


oon On 
— ee 


5-14 


7 Assembler Directives 7-1 
nits Greeuon oF Titsaeu.2o cource Code... . 6. 6 hE shea Roach Al 7-2 
7.1.1 et ON es eo ee ee ue, hia Sve 3 ee Db err wicaely See. 7-2 
FA2 Ree Po ge a 6 a ee ee Ee wo an Cpe ae TO. 7-3 
TA OIE 2g So eGdG pg de Sa Bae oe ae ee 5 beeen et 7-3 
7.1.4 eee se ae gh Boge meee poe ge ig a eee Sk ag: Soe a gt oo tal wees 7-3 
Tame Rae ee a Ee Age a alae a. oe Ss Va ies Re a ek x be phe ee 7-4 
Fate Pree IN? ore ey Ge ea a a a Oe Get ik We a ee ee 7-4 
Tat: SE a seek ee ara pa a bk ek ae PR eee 7-4 
Teckel Peete CRA a a ed PE OO ee eee 7-5 
tnd rt TS. a PRS ee a 6 OS. eee ee eee 7-5 
y je Prekececwna wigeer Constants = a i ee eee we eee 7-5 
7.3.4 eC tO a Gt sr ek a ke ee a Ae a ee ee ee ee 7-5 
Toe er -ee Gristente a a i a Ow ee ale sp cee es 7-6 
tase eee re ee a is a A a a oS ME Se ee Ee 7-6 
Pe I oe es es ee ye ek ae ak ss ee ea eee oS eee 7-6 
TSA perience (petetorm in: Exressione | a a a ew Se eee 7-7 
yee Prereroee Tr EOTORIONO. 5 a el ie a ee ae ae ee ae ees 7-7 
oe Wee ue ee a a a a we ew ee ee ee eee 7-7 
7.5.4 Absolute and Relocatable Symbols in Expressions ...............0084 7-8 
Takhio Externally Referenced Symbols in Expressions ............00 00804 4 7-8 
Juli, POO Or OCS a a a ae a ee Be ee 7-9 
7.6.1 Directives That Affect the Location Counter-© .. . 2... BUSSE 2 eee oS" 7-9 
7.6.2 Directives That Affect Assembler Output ............0..... 0.00048 | 7-10 
7.6.3 ineeuwes: ter ieee Gonsiats le ee 7-10 
7.6.4 Directives That Provide Linkage Between Programs  ................. 7-10 
7.6.5 erreurs Ce ae we i ee eo Ce ee ee OO ee ee ee 7-11 
“7 individual Directive Descriptions ..........4.-+... . J@eRe sre ceousceh 7-12 
782 Source Listmg Pormat . 6... ww he ee he ee eo Ce CIB VS cen 7-44 
Time TIOICE LOG ee te ee le te et a ee ORS Bie SI Geee Nn 7-45 
7.9.1 Obieet Code.Format. ......., . T07S3OIM nergy .c. Bae his Vesey 7-46 
7.9.2 Chasoma Chiect Code....... ...°. . . . 3-4 PRE SN ie aes eGs SSOOACSN 7-49 
AIG Cross-Reterence Listing OC bP Io 1S 4 F1SS I Gaave Shei eievad <2 Teh 7-50 
7:1¥- Assembler Error Messages 25°) 8° 856%. (oh i, RNS OG GHGs BITE GEN 7-51 
8 Assembler Macros 8-1 
eek I ore a a ce Wk Se ee ee ee ae eee oe Oy we SP cs Ete oe 8-2 
8.1.1 CPO SS oe) eg kg bok RS ce eee he ee See eee 8-4 
en Sg ete Oe rar ae BO arr ae 1g gO Rha Ere a aces eke OER So cele Bele ae - & oie 8-5 
ee en cere se Be eek a ce Re ie wise 4 mem ee ey ale Sey eae es 8-5 
ee eI Oe oe hu “AS ge ee GAS ee Sn Oe ES ewe Ge ee oe 8-5 
ce, Ft eA eg ee lg gi ce RN Gey Rabe mew od eee Oe Roa Gs ee 8-5 
8.5.1 ES hl ie Pee, 5g ce erties. wi Ge Albee ea ee kare ee eee Ua nn 8-6 
8.5.2 Brera rere TE) ge pe ba we ele be Be we Ss SE 8-6 
i re 90 oo. “Ge ee eda ke pera -« a Ww AeA Ew Ww ase aN poe’ 8-7 
ee re 2S go ae cg 6 Me ek Gad ee ee GE a, RGR een ao ee 8-9 
8.6.1 eee: ei Sg esse ie Boe ww ep ew a Spon Seek Bt yw Ne eee aes 8-9 
8.6.2 a Pak vce ww eS] a el wpe Se oe ay Rea ee 8-9 
8.6.3 Scene ect artes any tig a ee «ee BREE eke RST OD a RS 8-9 
ite oS Lok yg ate Wada 5) oS Gia ak. 4 ado Oo ReaD BEER eats 8-10 
8.7.1 Symbol Attribute Component Keywords ....... 2... ee 8-10 
Ss .2 Parameter Attribute Component Keywords ......... eee ee ee ee 8-10 
eet ORO ee ge gg ye See 8 ew <a ee Rak Meee ee acm 8-11 
8.8.1 SASG (Value Assignment Verb) «6 we a ee ee ew ee es 8-11 
8.8.2 Pee. Cerne SP) a 5 re i ew a we we ee 8-13 
8.8.3 SEND (Macro Definition Termination Verb) ............. 00.00 eee 8-13 
8.8.4 Perec Cie Pt EOD eee ee we ee ew OU wea whale 8-13 
ee re ee a eet ae ee ae on ee ee oe ee 8-13 
8.8.6 SAA ence tere) Verb) we ee eee ee 8-14 
8.8.7 SVAR (Vanable Declaration Verb) 6 cw ee 8-17 


Oe . Niel Sisiemants 2. = oS - oeekce S. eiax o Es ee ee ae 8-17 
S70 Maem Exvomeies Sc a a a a ee i ee 8-18 
8.10.1 ID (Identification Macro) BO Ge an wa ge Ee ee a eee ot hr POTS 8-18 
$40:2 -GENCME (Génemte Comment Macto). = «wr a et ey PP SONS. 8-19 
S103. BAG tee ee: a a ea Oe eee Eee, 8-20 
ot ee re NG tse a a i a a ee a a ee ee 8-20 
9 Link Editor 9-1 
By = ong a Sloe ee RE OE ae ee alee ee RO ee eee 9-2 
ae = Se ee eS Ss an eek ee eS 8 Sd Se nee ee ea 9-2 
6 ee a eo ss a eee a Se eS RRS ce a eee ee ee ee 9-3 
9.3.1 pee CR cts eS en ae els ee ck he eee ea ea a 9-3 
9.3.2 nt ee ek a ee ee ee er A ee ee eee a eee 9-3 
9.3.3 Seen 5 ol ee ek SS A ee oe ae ee ee ees 9-4 
9.3.4 ES mNUINRE PREIN2  52  oe es g cg Sa gg ek Rom oe eran peak 9-4 
S330 mR = rf ys cy oe aS es oe a ee ee ee ee 9-4 
Stee ere ne os ee ES ee ee a eB ee A ae 9-5 
9.4.1 Eran arn. a, baa eek a) re Se ee ee ae eas 9-5 
9.4.2 tee Greet. Ss ea a eR ew 8 8 Re eer ai 9-5 
9.4.3 IngwigweEGONMMANG DOSCIiDIIONG ojo a ek ah) oe a aaa? Cet Br an 9-7 
aa 2 Ss e ee Be R he  E  e eO 9-36 
9.5.1 er a Sig Sa SS ee en ea a Ss ee oP ee cae wae a 9-39 
952 Pe ee Te OS a hee ees Ce ee 9-41 
9.5.3 Parmer ee a Ris 2S 5 ee nd BE ee en ee Se ee ms 9-43 
9.5.4 emer a ONES a ae ee oe gS a de ee 9-47 
lee Ly ee er Pe RNOGS ke ac cb ee ee Ls I a 9-50 
A  TMS320C25 Data Sheet A-1 
B §TMS32020 Data Sheet B-1 
C TMS320C10 Data Sheet C-1 
D TMS32020/TMS320C25 System Migration D-1 
E TMS320C25 Instruction Cycle Timings E-1 
F TMS320C25 Development Support/Part Order Information F-1 
G TMS320C25 Macro Assembler and Link Editor Installation G-1 


vi 


Illustrations 


Figure 

t-t.. IT MS320CZ25 Digital Signal: Processor. 2. <. oP. Bett eekl jAurnotneegoekes . 
get. TAR eC ee Bigck DiINGrany = wt ke nw Ree win ele is eee Oe ele 
gma. IMSS2Z0CZ5 Pin ASBIGNMents =«§«_i«w a ee ei oe eRe Dede) HOseiolahassne. 
eu. Lee MOIMOTY PAGDS we ee ee avs es es wees os PR aloha we oes 
aa: . AMATIATUNT PIOCSSSING SYSIOM.. .. ce inane bd ered dane eee er ole i eho. | 
2-9: -Global Memory Parallel Processing. ws ke pee we ee PORTAL Chi ee otaes 
2-6. Host/Peripheral Coprocessing Using Interface Control Signals ..............0..... 
2: TMS320C2Z5 Development Support =§<.....- >. wheres MARPRIOS. 63 eieeeciee s. 
ah TMSszeueo- eiock Diorama. ec tae k Settee Dae eee pate eh? bee ona - 
s-2: -On-GChip Data Memory x. we este ini dileiesetd ons naegini gt calle beeen hos oesol. 
Bs  AGGTIONVEMADS ic ew es ts ne oe ER ROT WER Gee ei eue es. 
3-4. Indirect Auxiliary Register Addressing Example... 6. ee 
o-&e ~ -Aiseiiary Pecigter Fie cn ve re nv ss FRE HG ine awate alone OLE PAL. 
3-6; Methods of Instruction Operand Addressing ..:: <0) aes @ paleo DEE we BE OPER ERT. 
oA. Central Arithmetic Logic Unit (CALU) oi. ce ri. vs saealonoainlt OES SAR : 
Sa Te ee Oe ID ng yi a os eee Oe ale ek ka) Se ONE ER we 
3-9. Program Counter end Related Hardware «s-wave cbc ah ep weee bd neus 
3-700; Piree- Level Piggies COGrtOn.- cs ki eh ee be ee ee Es oe Pe ed ee ee 
ond to eee ee OR i ae alae pes ak Be BES ee ge ee Ee eS oe 
3-12: Pipeline peration During GANZ Instruction: ~.-..6 ee ce le eee ee ee we 
3-13. Pipeline Operation When Crossing Program Boundaries ............ 2. eee 
aoe eee Pree a es ees ek en wes ee te Oe oa eae ee 
ok ae cae AMER iif ne cs Skee i <n eh 8 Pe es eed bE as 
a nS an aoa dix eo eee ee See ce ee ees ee ee ee 
aX ae, SPIN Set OPE TPA 2 ee a ee '® o Ee ee we a be a ee 
3-18. Functional Timing of Write Cycles and Wait States «6g. ee 
o~ 1 WPS ee PISO EI) i, Sew ace bla ce peace MEd ee Rea ee ae ee 
3-20: Internal.interrupt-Logic Diagram... ..... .. «6. PETIA ASV GARE OLAG BAO RGIHOW ss SAY L 
oa... inferupt Timing Didgram ...-. 0... 6. wan eae es BE RDUTAR RIG JER Comer 
6-22. The DRR:and DXR Registers .. 0.6. ee ee ei ev eka ass ROR BSCE EIOA. 
3-23.53. q0tia-Fom-Giotk DisGram. = oi ee eae vee ee a ws SS FRO 
3-24.. Burst- Mode. Serial. Port: Transmit.Operation....... 0.4.2.0... . SUDO ROT SS RR eee | 
3-25. Burst- Mode Serial. Port Receive Operation... 0 6. cance eee oe ORNS, RST. 
$25:: Byte- Mode DRR-Operation: a ee ee eh ee ee ISLET RE a. 
3-27. Serial Port Transmit Continuous Operation (FSM=1) —s 1. ce ee ee ee ee 
3-28. Serial Port Receive Continuous Operation (FSM=1) —s ww ee ee 
3-29. Serial Port Transmit Continuous Operation (FSM=0) —... oe ee ee 
3-30. Serial Port Receive Continuous Operation (FSM=0) sw. ee ee 
3-31... Continuous Transmit Operation Initialization = @b Bae BERET OOS ERRIBR aa . 
3-32.: Continuous -Receive Operation Initialization .. «...... BOI 2IR Ws POSE a eae SiG, 
3-33. Synchronization Timing Diparam .. os os cass i een te ts os >» CER S AEIOR 
3-34, Global: Memory Access: TIMING «= ni. ke es a oe ws oo BU RS Se REO 
3-30. Hold Timing Diagram ©. 0. SE Se eS 9G PROT PRs IRS Ta 
6-36. Bis FHiming Diegram: eo. a ee caw ee PRD PERU, PRE DRCR YORI re. 
3-37.. Extemal-Fiag- Timing Diagram. 9 4771S) SPaV SSeS Pi OP nS POON Fe SBM AGE VES . 
4-7. - Direct Addressing Block Diagram 9 (72134 PSL EP OS ON RVG OPE GOA Pe ASSET 
4-2. - indirect Addressing Biock-Diagram «4 FBP PS OP oe PRS ED SES, ees, 
5-T.. -On-Chip RAM Configurations.- ........ S229 7 0¥s. PES ARV Pe PS, RAP Sra. 
5-2.-: MACD- Operation. -..... FPURIRPT Ss PePre eS. SGA Se SE. SSE OPTS, aga . 
5-3. Execution Time vs. Number of Multiply-Accumulates =... 2 ee ee ee 
5-4. Program Memory vs. Number of Multiply-Accumulates =... se ee 
5-5. An In-Place DIT FFT with In-Order Outputs and Bit-Reversed Inputs =... ........... 
5-6. An In-Place DIT FFT with In-Order Inputs but Bit-Reversed Outputs ............... 
6-1. - Minimal External Program Memory Configuration. ......5... 2.807 585009 PPS 


Vil 


6-2. .One Wait-Stete Memory Access Fite ow ce tee eee ee ee eee ree 
6-3; One Wait-State Generator Using te 2. kb ES ee ee ee eee es 
6-4. Direct Memory Access Using a Master-Slave Configuration ......... 2... eee eee 
6-5. Direct Memory Access ina PC Environment  ...... ci eee ewe eee 
G8; = Seger ree ett... ie eis Ss SL ws Pee we ee Oe ee ee 
ey oe ee EN era gS re ie a CE w RP AIOE bed ee le ee EPs a 
ees 70ers ee ae gh oie CLE ROE EE OT Ea oA EA STS 
6-9. 1/0 Port Processor-to-Processor Communication... ince ccc cece ese eee ee a 
F'” .- Seume-Sistement ing Oxanio -. ee ns CREPES OEP EES A Re PES 
Peay - Seles Cree ei ea eo ee ee DEP EP a SEES Le 
PS. (yogs-Rererence Using Founat ~~ 4 ...... 6.8. eee SPR Sr ee Pee b 
oT SGC CC EC PREE nels hs os a EAS RO oe PE ee Mee ee ee VEEP EN» 3 
2. - BOGE Tl Oe eel ee es eb EN vied bere be ee Bree eee OP be ree. 
te, SOURCE TOL PRs INTE a eo a eee eae ee eee ee er ee eee eae eres 
Ligne -rie fore sinow Links = eis ae OPP PAR Ey A a a Oe Pee 
3-5. - Listing Pile-tor ROM/BRAM Partitioning  ........ 05 Pa a ree eave Pee. 
S.6. .. Listina-ane Coiect Files fora Partial Link .- . .. 0 bee a err 
9-7. Listing and Object Files for Relinking the Partial Link Output = ..................... 
9-8: -Source File for Sequential Library Greation- «6... ce ee ee ee eens 
=F. SerBe rant seve Paint Si 3 ey Se Ee i ees 
F-*: --PiiSa20 Fomiyv Deveonment Suppor. on hee ee tba ee peeve 
F-2. TMS320C25 xDS/22-Emulator System Configuration’! 2. ee Tae, . 
Fg. Fes ae Pe Sk ee Ne ee ew a ee ie ee Ce es 
Tables 

Table 

t+ Typical Anplicatione of the-TMSS2Z0 Family ...... 1. @8enth eed, Saal terieinl . 
Bet, Tiere) OL IONE ke wan aw danse ves See Coae S loaatiel . 
ae. > as Sees ee es is awa ead de MOOS we DOE. SHG. Shi. 
oak. ET POS kg ke ks ee rk sae wo ade we dle eo Re Saale. he aleies « 
2-6 Te ae AO CUIONG | ns oak cB vo bo ae CHOSE UE Ge a leeipe et fouia . 
oe-e APY POE OSS. ae ons ce oes oes HO REID AOE Rare BSS Sheds ee 
en. BROT RING -TOMIGIOrS |. ce ce wk adda nes SRG EMS SEO eles. 
Sod; 7 a bene oS hn os oo ee he ba BEN Hal Lee Cie eR enea. 
sm, State Reamer Field Delinitions fs e468) isis G. win Bw Loe iat. Wee deus? 
oe - erupt Locations @nd Priouties = sc. AGC we atiaeall cde ced Hive aod Jéiass « 
3-6:. Global Data Mamory Gonraurations Gali oo i swiewed Dae RS evi Se Jeske. 
4-1. Indirect Addressing Arithmetic OperationS —=s wn de eee ees 
4-2; Bit Fisies tor niavect moamenna = a... . eb ebdeei Peieeet? otiatel. scusGaind. 
rd... Mae a eta ete ae eee aa a 8 | RED OUM RAS CDUOL Cab enye » 
Bri, APIO eee ITY a hs ww hes nt do wd os DRE RAO MY MO ory 
5-1. Bit-Reversal Algorithm for an 8-Point Radix-2 DIT FFT —s.... ee ee 
5-2... FFI Memory Space and Time Requirements oo 6... ee we Ce SRN ade 
7-1. Results of Operations on Absolute and Relocatable Items sw wd we ee 
7-2. Assembler Directives That Affect the Location Counter ........... 0... 
7-3. Assembler Directives That Affect Assembler Output = 6... ee es 
7-4. Assembler Directives That Initialize Constants .... 1... ee es 
7-5. Assembler Directives That Provide Linkage Between Programs .......... eee eee ees 
7-6. Miscellaneous Assembler Directives == 1. dd ee eee es 
7-7. Assembler Directive Symbols —...... 1... . ee es eituaalle Hoos Ae BRAGS » 
F-Bi CSE OGOrG, PONAG- BF BOG re. 5 Ao yc oe oe ay ee same dee oer 8 Pore asl Ae 
72S. PBR SV rE oc ee Bc aoc bes owiehe SY ep rite oe ar alee 
Tas PRET rE SE ad op le ane die oi aa Os Gheeeo ree asic eee SATO 


Viil 


a ee ed SON eo ee ets ak eee gee ee eS. Gap GG ATF ae Pie ee ee 7-53 
7-12s Beeemory- information. iiessage Listing. «6... ae a ee eS wee ee cede 7-54 
rk cae oe ts ae ee es os Sa ee ek ae Pe wn ed Bae eo 8-7 
8-2: Variable Qualifiers for Symbol Components «= ssc ee a ce ee wea eee 8-8 
8-5: oye! mitibiuite Component heywotds... i ec eee ee ee eb he eee eas 8-10 
8-4. Parameter Attribute Component Keywords... . 2... ee 8-11 
ee en we ce ee aan oO an re ew ale boee ge ed ew ee a a ee 8-20 
Sa 1. es ee ey. aks Se Sh eC wt F ins pe ee ee ee ce es Ee 9-5 
O- 2. EAE rs EY ee as ae ee ESE le we EG a BERS 9-6 
E-1:. “Fieazoeo mewuerons by Cycle Class «= os Se oes es ORG eee eee re E-1 
E-2. Cycle Timings for Cycle Classes When Not in Repeat Mode ..............000 eee E-2 
E-3. Cycle Timings for Cycle Classes When in Repeat Mode ............ cee ee E-4 


1. 


Introduction 


The TMS320C25 Digital Signal Processor is a member of the TMS320 family of VLSI 
digital signal processors and peripherals. The TMS320 family supports realtime 
digital signal processing (DSP) and computation-intensive applications in the areas 
of telecommunications, modems, speech processing, graphics/image processing, 
spectrum analysis, audio processing, digital filtering, high-speed control, instru- 
mentation, and numeric processing. 


The architectural investment made in the TMS320 family provides the user with a 
choice of five distinct processors (TMS32010, TMS320C10, TMS32011, 
TMS32020, TMS320C25) to best support a wide spectrum of DSP applications. 
Software compatibility is maintained throughout the family to protect the user’s 
investment in the architecture. Each processor has software and hardware tools to 
facilitate rapid design. 


The first processor in the TMS320 family is the TMS32010, a microcomputer with 
a 32-bit internal Harvard architecture and a 16-bit external interface capable of 
executing five million instructions per second. The TMS32020 is the next processor 
in the family with an architecture based on that of the TMS32010. Major architectural 
changes made on the TMS32020 enable the device to lower system cost and improve 
throughput by two to three times over the TMS32010 for DSP applications. The 
TMS32020 instruction set is a superset of that of the TMS32010, thus maintaining 
software compatibility. 


The TMS320C25 is a pin-compatible CMOS version of the TMS32020 with a faster 
instruction cycle time and the inclusion of additional hardware and software features. 
The TMS320C25 is completely object code-compatible with the TMS32020 so that 
TMS32020 programs run unmodified on the TMS320C25. Some of the major 
enhancements of the TMS320C25 over the TMS32020 are as follows: 


Faster instruction cycle time: 100 ns 

Low-power CMOS technology with powerdown mode 

4K words of on-chip masked ROM 

Eight auxiliary registers with a dedicated arithmetic unit 
Eight-level hardware stack 

Fully static double-buffered serial port 

Concurrent DMA using an extended hold operation 
Bit-reversed addressing modes for radix-2 FFTs 
Extended-precision arithmetic and adaptive filtering support 
Full-speed operation of MAC/MACD from external memory 
Accumulator carry bit and related instructions 


Development tools and applications support are key advantages to using the 
TMS320C25. Full-speed emulators, software simulators and assemblers, and exten- 
sive documentation including over 735 pages of application reports provide for rapid 
design and development cycles. Texas Instruments regional technology centers, 
system application engineers, and third-party support are available for DSP educa- 
tion, training, and design. 
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1.1 General Description 
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The TMS320C25 architecture is based upon that of the TMS32020 digital signal 
processor. The TMS320C25 increases performance of DSP algorithms through a 
faster instruction cycle time and innovative additions to the TMS320 family archi- 
tecture. The TMS320C25 is object code-compatible with the TMS32020, thus 
enabling current TMS32020 programs to run unmodified on the TMS320C25. 


Two versions of the TMS320C25 are available to support price and performance 
requirements for different applications: 100-ns and 125-ns instruction cycle time 
versions. 


The 100-ns instruction cycle time provides double the throughput for existing 
applications. Since most instructions are capable of executing in a single cycle, the 
processor is capable of executing ten million instructions per second (10 MIPS). 
Increased throughput on the TMS320C25 for many DSP applications is attained by 
means of single-cycle multiply/accumulate instructions with a data move option, 
eight auxiliary registers with a dedicated arithmetic unit, instruction set support for 
adaptive filtering and extended-precision arithmetic, bit-reversal addressing, and 
faster |/O necessary for data-intensive signal processing. 


The architectural design of the TMS320C25 emphasizes overall system speed, 
communication, and flexibility in processor configuration. Control signals and 
instructions provide block memory transfers, communication to slower off-chip 
devices, multiprocessing implementations, and floating-point support. 


Two large on-chip data RAM blocks (a total of 544 words), one of which is 
configurable either as program or data memory, provide increased flexibility in system 
design. An off-chip 64K-word directly addressable data memory address space is 
included to facilitate implementations of DSP algorithms. The large on-chip 4K-word 
masked ROM can be used to cost-reduce systems, thus providing for a true 
single-chip DSP solution. Programs of up to 4K words can be masked into the 
internal program ROM. The remainder of the 64K-word program memory space is 
located externally. Large programs can execute at full speed from this memory space. 
Programs may also be downloaded from slow external memory to on-chip RAM for 
full-speed operation. The VLSI implementation of the TMS320C25 incorporates all 
of these features as well as many others such as a hardware timer, serial port, and 
block data transfer capabilities. 
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Figure 1-1. TMS320C25 Digital Signal Processor 
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1.2 Typical Applications 


The TMS320 family’s unique versatility and power offer a new approach to a variety 
of sophisticated applications. Table 1-1 lists some typical applications of the 
TMS320 family. 


Table 1-1. Typical Applications of the TMS320 Family 


GENERAL-PURPOSE DSP GRAPHICSAMAGING INSTRUMENTATION 


Digital Filtering - 3-D Rotation Spectrum Analysis 
Convolution Robot Vision Function Generation 
Correlation Image Transmission/ Pattern Matching 
Hilbert Transforms Compression Seismic Processing 
Fast Fourier Transforms Pattern Recognition Transient Analysis 
Adaptive Filtering Image Enhancement Digital Filtering 
Windowing Homomorphic Processing Phase-Locked Loops 
Waveform Generation Workstations 

Animation/Digital Map 


VOICE/SPEECH CONTROL MILITARY 


Voice Mail Disk Control Secure Communications 
Speech Vocoding Servo Control Radar Processing 

Speech Recognition Robot Control Sonar Processing 
Speaker Verification Laser Printer Control Image Processing 

Speech Enhancement Engine Control Navigation 

Speech Synthesis Motor Control Missile Guidance 

Text to Speech Radio Frequency Modems 


TELECOMMUNICATIONS AUTOMOTIVE 


Echo Cancellation FAX Engine Control 


ADPCM Transcoders Cellular Telephones Vibration Analysis 
Digital PBXs Speaker Phones Antiskid Brakes 

Line Repeaters Digital Speech Adaptive Ride Control 
Channel Multiplexing Interpolation (DSI) Global Positioning 
1200 to 19200-bps Modems X.25 Packet Switching Navigation 

Adaptive Equalizers Video Conferencing Voice Commands 
DTMF Encoding/Decoding Spread Spectrum Digital Radio 

Data Encryption Communications Cellular Telephones 


CONSUMER INDUSTRIAL MEDICAL 


Radar Detectors Robotics Hearing Aids 
Power Tools Numeric Control Patient Monitoring 
Digital Audio/T V Security Access Ultrasound Equipment 
Music Synthesizer Power Line Monitors Diagnostic Tools 
Educational Toys Prosthetics 

Fetal Monitors 
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Many of the TMS320C25’s features, such as single-cycle multiply/accumulate 
instructions, 32-bit arithmetic unit, large auxiliary register file with a separate arith- 
metic unit, and large on-chip RAM and ROM, make the device particularly applicable 
in digital signal processing systems. At the same time, general-purpose applications 
of the TMS320C25 are greatly enhanced by its large address spaces, on-chip timer, 
serial port, multiple interrupt structure, provision for external wait states, and multi- 
processor interface capability. 


The flexibility of the TMS320C25 allows it to be configured to satisfy a wide range 
of system requirements. This allows the device to be applied in systems currently 
using costly bit-slice processors or custom ICs. Some of the system configurations 
are: 


@ A standalone system using 4K words of on-chip ROM and 544 words of 
on-chip RAM 

@ Parallel multiprocessing systems with shared global data memory 

& Host/peripheral coprocessing using interface control signals. 


1.3 Key Features 


The TMS320C25 Digital Signal Processor offers a cost-effective alternative to custom 
VLSI and bit-slice devices. It has the following significant key features: 


100-ns instruction cycle time 
544 words of on-chip data RAM 
4K words of on-chip masked ROM 
128K words of data/program space 
Single-cycle multiply/accumulate instructions 
Object code-compatible with the TMS32020 
16-bit instruction and data words 
32-bit ALU and accumulator 
16-bit parallel shifter 
Block moves for efficient data/program management 
Unsigned multiply instruction for extended-precision arithmetic 
Carry bit with associated add and subtract instructions 
Instructions for floating-point operations and adaptive filtering 
Eight auxiliary registers and a dedicated arithmetic unit 
Bit-reversed indexed addressing mode for radix-2 FFTs 
Wait states for communication to slow off-chip memories/peripherals 
Double-buffered static serial port for direct codec interface 
Three external, maskable user interrupts 
Synchronization capability between multiple processors 
On-chip clock generator 
1.8-micron CMOS technology; single 5-volt supply 
68-pin plastic leaded chip carrier (PLCC) 
Two versions available: 

40-MHz clock 

32-MHz clock 
@ Commercial and military versions supported. 
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1.4 How To Use This Manual 


1-6 


The purpose of this user’s guide is to serve as a reference book for the TMS320C25 
Digital Signal Processor. Sections 2 through 6 provide specific information about the 
architecture and operation of the device, and Sections 7 through 9 describe how to 
use the macro assembler/linker support software. TMS320C25 electrical specifica- 
tions and mechanical data can be found in the data sheet (Appendix A). 


This user’s guide is designed to provide information that assists managers and 
hardware/software engineers in application development. The Introduction and 
Architectural Overview sections provide managers with basic information that 
describes the capabilities of the TMS320C25 for a particular application. The hard- 
ware engineer will find the Architectural Overview, Device Operation, and Hardware 
Applications sections and the Data Sheet and System Migration appendices most 
helpful. The Assembly Language Instructions, Software Applications, Assembler 
Directives, Macros, and Link Editor sections and the Instruction Cycle Timings, 
Development Support, and Software Installation appendices will aid the software 
engineer. 


The following table lists each section and briefly describes the section contents. 


Section 2. Architectural Overview. Brief description of the TMS320C25 
hardware components and their functions. Block diagram, pinout 
of the 68-pin plastic leaded chip carrier (PLCC) package, a table 
of signal descriptions, and a list of TMS320C25 instructions. 


Section 3. Device Operation. TMS320C25 design description, hardware 
components, and their functions. Functional block diagram and 
internal hardware summary table. 


Section 4. Assembly Language Instructions. Addressing modes and format 
descriptions. Instruction set summary listed according to function. 
Alphabetized individual instruction descriptions with examples. 


Section 5. Software Applications. Software application examples for the use 
of various TMS320C25 instruction set features. 


Section 6. Hardware Applications. Hardware design techniques and applica- 
tion examples for interfacing to codecs or external memory. 


Section 7. Assembler Directives. Description of assembly language source 
statement, source listing, and object code format. Individual 
assembler directive descriptions in alphabetical order. Assembler 
error diagnostics. 


Section 8. Assembler Macros. Description of macro assembly language 
elements. Individual macro verb descriptions. Several macro 
examples given. Macro error diagnostics. 


Section 9. Link Editor. Description of link editor and its files. Individual linker 
command descriptions in alphabetical order. Examples of simple 
linking, ROM/RAM partitioning, partial linking, and library creation 
given. Linker error diagnostics. 


Seven appendices are included to provide additional information. 


Appendix A. ITMS320C25 Data Sheet. Electrical specifications, timing, and 
mechanical data for the TMS320C25. 


Appendix B. IMS32020 Data Sheet. Electrical specifications, timing, and 
mechanical data for the TMS32020 Digital Signal Processor. 
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Appendix C. TMS320C10 Data Sheet. Electrical specifications, timing, and 


mechanical data for the TMS320C10 Digital Signal Processor. 


Appendix D. TMS32020/TMS320C25 System Migration. Information for 


upgrading a TMS32020-based system to a TMS320C25-based 
system. 


Appendix E. TMS320C25 Instruction Cycle Timings. Listing of the number of 


cycles for an instruction to execute in a given memory configura- 
tion. 


Appendix F. TMS320C25 Development Support/Part Order Information. List- 


ings of the hardware and software available to support the 
TMS320C25. 


Appendix G. TMS320C25 Macro Assembler and Link Editor Installation. Series 


1.5 References 


of procedures used to install and verify the TMS320C25 Macro 
Assembler and Link Editor on a VAX or TI/IBM PC. 


The following reference list contains useful information regarding functions, oper- 
ations, and applications of digital signal processing. These books also list other 
references to many useful technical papers. The references are organized into cate- 
gories of general DSP, speech, image processing, and digital control theory. 


General Digital Signal Processing: 


Antoniou, Andreas, Digital Filters: Analysis and Design. New York, NY: 
McGraw-Hill Company, Inc., 1979. 


Brigham, E. Oran, The Fast Fourier Transform. Englewood Cliffs, NJ: Pren- 
tice-Hall, Inc., 1974. 


Burrus, C.S. and Parks, T.W., DFT/FFT and Convolution Algorithms. New York, 
NY: John Wiley & Sons, Inc., 1984. 


Digital Signal Processing Applications with the TMS320 Family, Texas \nstru- 
ments, 1986. 


Gold, Bernard and Rabiner, Lawrence R., Theory and Application of Digital 
Signal Processing. Englewood Cliffs, NJ: Prentice-Hall, Inc., 1975. 


Gold, Bernard and Rader, C.M., Digital Processing of Signals. New York, NY: 
McGraw-Hill Company, Inc., 1969. 


Hamming, R.W., Digital Filters. Englewood Cliffs, NJ: Prentice-Hall, Inc., 1977. 


IEEE ASSP DSP Committee (Editor), Programs for Digital Signal Processing. 
New York, NY: IEEE Press, 1979. 


Jackson, Leland B., Digital Filters and Signal Processing. Hingham, MA: Kluwer 
Academic Publishers, 1986. 


Morris, L. Robert, Digital Signal Processing Software. Ottawa, Canada: Carleton 
University, 1983. 


Oppenheim, Alan V. (Editor), Applications of Digital Signal Processing. 
Englewood Cliffs, NJ: Prentice-Hall, Inc., 1978. 
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Oppenheim, Alan V. and Schafer, R.W., Digital Signal Processing. Englewood 
Cliffs, NJ: Prentice-Hall, Inc., 1975. 


Oppenheim, Alan V. and Willsky, A.N. with Young, I.T., Signals and Systems. 
Englewood Cliffs, NJ: Prentice-Hall, Inc., 1983. 


Parks, T.W. and Burrus, C.S., Digita/ Filter Design. New York, NY: John Wiley 
& Sons, Inc., 1986. 


Speech: 


Gray, A.H. and Markel, J.D., Linear Production of Speech. New York, NY: 
Springer-Verlag, 1976. 


Jayant, N.S. and Noll, Peter, Digital Coding of Waveforms. Englewood Cliffs, 
NJ: Prentice-Hall, Inc., 1984. 


Papamichalis, Panos, Practical Approaches to Speech Coding. Englewood 
Cliffs, NJ: Prentice-Hall, Inc., 1986. 


Rabiner, Lawrence R. and Schafer, R.W., Digital Processing of Speech 
Signals. Englewood Cliffs, NJ: Prentice-Hall, Inc., 1978. 


Image Processing: 


Andrews, H.C. and Hunt, B.R., Digita/ /mage Restoration. Englewood Cliffs, 
NJ: Prentice-Hall, Inc., 1977. 


Gonzales, Rafael C. and Wintz, Paul, Digital Image Processing. Reading, MA: 
Addison-Wesley Publishing Company, Inc., 1977. 


Pratt, William K., Digita/ Image Processing. New York, NY: John Wiley & Sons, 
1978. 


Digital Control Theory: 
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Jacquot, R., Modern Digital Control! Systems. New York, NY: Marcel Dekker, 
Inc., 1981. 


Katz, P., Digital! Control Using Microprocessors. Englewood Cliffs, NJ: Pren- 
tice-Hall, Inc., 1981. 


Kuo, B.C., Digital Contro/ Systems. New York, NY: Holt, Reinholt and Winston, 
Inc., 1980. 


Moroney, P., /ssues in the Implementation of Digital Feedback Compensators. 
Cambridge, MA: The MIT Press, 1983. 


Phillips, C. and Nagle, H., Digital Control System Analysis and Design. 
Englewood Cliffs, NJ: Prentice-Hall, Inc., 1984. 


2. Architectural Overview 


The TMS320C25 high-performance digital signal processor implements a single- 
accumulator, Harvard-type architecture in which program and data memory reside 
in separate address spaces. This allows a full overlap of instruction fetch and 
execution. Instructions are included to provide data transfers between the two 
spaces. Externally, the program and data memory spaces are multiplexed over the 
same bus so as to maximize the address range for both spaces while minimizing the 
pin count of the device. Internally, the TMS320C25 architecture maximizes proc- 
essing power by maintaining two separate bus structures, program and data, for 
full-speed execution. Increased flexibility in system design is provided by two large 
on-chip data RAM blocks, one of which is configurable either as program or data 
memory. 


The TMS320C25 incorporates a separate level of pipelining for instruction decoding. 
The instruction fetch-decode-execute pipeline is essentially invisible to the user, 
except in some cases where the pipeline must be broken (such as for branch 
instructions). In this case, the instructions will have slightly different timing charac- 
teristics than the TMS32020. Other instructions, such as those that operate with 
external data memory, have improved cycle timings compared to the TMS32020. The 
device executes the majority of its instructions in a single machine cycle when 
sufficiently fast memory is utilized. The device may also communicate to slower 
off-chip memories or peripherals by utilizing the READY signal. In those cases, the 
instructions become multicycle. 


The major topics discussed in this section are as follows: 


% Functional Block Diagram (Section 2.1 on page 2-3) 

@ Pinout and Signal Descriptions (Section 2.2 on page 2-3) 

ra Memory (Section 2.3 on page 2-7) 

@ Central Arithmetic Logic Unit (CALU) (Section 2.4 on page 2-10) 
@ System Control (Section 2.5 on page 2-11) 

® |/O Interface (Section 2.6 on page 2-12) 

@ System Configurations (Section 2.7 on page 2-12) 

@ Addressing Modes and Instructions (Section 2.8 on page 2-15) 


& Development Support (Section 2.9 on page 2-22) 
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LEGEND: 
ACCH = Accumulator high IFR = Interrupt flag register PC = Program counter 


ACCL = Accumulator low IMR = Interrupt mask register PFC = Prefetch counter 

ALU = Arithmetic logic unit IR = Instruction register RPTC = Repeat instruction counter 
ARAU = Auxiliary register arithmetic unit MCS = Microcall stack GREG = Global memory allocation register 
ARB = Auxiliary register pointer buffer QIR = Queue instruction register RSR = Serial port receive shift register 


ARP = Auxiliary register pointer PR = Product register XSR = Serial port transmit shift register 
DP = Data memory page pointer PRD = Period register for timer ARO-AR7 = Auxiliary registers 

DRR = Serial port data receive register TIM = Timer STO,ST1 = Status registers 

DXR_~ = Serial port data transmit register TR = Temporary register 


Figure 2-1. TMS320C25 Block Diagram 
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2.1 Functional Block Diagram 


The functional block diagram of the TMS320C25, shown in Figure 2-1, outlines the 
principal blocks and data paths within the processor. The diagram also shows all of 
the TMS320C25 interface pins. 


The TMS320C25 architecture is built around two major buses: the program bus and 
the data bus. The program bus carries the instruction code and immediate operands 
from program memory. The data bus interconnects various elements, such as the 
Central Arithmetic Logic Unit (CALU) and the auxiliary register file, to the data RAM. 
Together, the program and data buses can carry data from on-chip data RAM and 
internal or external program memory to the multiplier in a single cycle for 
multiply/accumulate operations. 


The TMS320C25 has a high degree of parallelism; e.g., while the data is being 
operated upon by the CALU, arithmetic operations may also be implemented in the 
Auxiliary Register Arithmetic Unit (ARAU). Such parallelism results in a powerful 
set of arithmetic, logic, and bit-manipulation operations that may all be performed 
in a single machine cycle. 


2.2 Pinout and Signal Descriptions 


The TMS320C25 is packaged in a 68-pin plastic leaded chip carrier (PLCC). The 
electrical specifications and mechanical data are given in Appendix A, the 
TMS320C25 Data Sheet. Figure 2-2 shows a pinout of the TMS320C25 PLCC 
package. Table 2-1 lists each TMS320C25 signal, its pin location, function, and 
input, output, or high-impedance state (1/O0/Z). The signals in Table 2-1 are grouped 
according to function and alphabetized within that grouping. 


Adaptor sockets are commercially available to convert a TMS320C25 PLCC package 
to a TMS32020-like 68-pin grid array (PGA) footprint, thus maintaining plug-in 
compatibility. 
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Figure 2-2. TMS320C25 Pin Assignments 
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Table 2-1. TMS320C25 Signal Descriptions 


SIGNAL | PIN | 1/0/zt DESCRIPTION 
ADDRESS/DATA BUSES 


A15 MSB Parallel address bus A15 (MSB) through AO (LSB). Multiplexed to address external 
data/program memory or |/O. Placed in high-impedance state in the hold mode. 


Parallel data bus D15 (MSB) through DO (LSB). Multiplexed to transfer data between 
the TMS320C25 and external data/program memory or I/O devices. Placed in high- 
impedance state when not outputting or when RS or HOLD is asserted. 


INTERFACE CONTROL SIGNALS 


Data, program, and |/O space select signals. Always high unless low level asserted for 
communicating to a particular external space. Placed in high-impedance state in the 
hold mode. 


Data ready input. Indicates that an external device is prepared for the bus transaction to 
be completed. If the device is not ready (READY = 0), the TMS320C25 waits one cycle 
and checks READY again. READY also indicates a bus grant to an external device after 
a BR (bus request) signal. 


Read/write signal. Indicates transfer direction when communicating to an external device. 
Normally in read mode (high), unless low level asserted for performing a write operation. 
Placed in high-impedance state in the hold mode. 


Strobe signal. Always high unless asserted low to indicate an external bus cycle. Placed 
in high-impedance state in the hold mode. 


MULTIPROCESSING SIGNALS 


Bus request signal. Asserted when the TMS320C25 requires access to an external global 
data memory space. READY is asserted to the device when the bus is available and the 


bin global data memory is available for the bus transaction. 
Hold input. When asserted, the TMS320C€25 places the data, address, and control lines 
in the high-impedance state. 
Hold acknowledge signal. Indicates that the TMS320C25 has gone into the hold mode 
and that an external processor may access the local external memory of the TMS320C25. 
ee Synchronization input. Allows clock synchronization of two or more TMS320C25s. SYNC 


is an active-low signal and must be asserted on the rising edge of CLKIN. 
Tt Input/Output/High-impedance state 
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Table 2-1. TMS320C25 Signal Descriptions (Concluded) 
| SIGNAL | PIN 1/0/21)" yriraieio9g .. DERGRIPTION = feet ee gece a | 


INTERRUPT AND MISCELLANEOUS SIGNALS 


BIO Branch control input. Polled by BIOZ instruction. If low, the TMS320C25 executes a 
branch. This signal must be active during the BIOZ instruction fetch. 
[ACK Interrupt acknowledge signal. Output is only valid while CLKOUT1 is low. Indicates 


receipt of an interrupt and that the program is branching to the interrupt-vector location 
indicated by A15-A0. 


INT2 22 External user interrupt inputs. Prioritized and maskable by the interrupt mask register 

fe 4 and the interrupt mode bit. 

aap: Microprocessor/microcomputer mode select pin. When asserted low, the pin causes the 
internal ROM to be mapped into the lower 4K words of the program memory map. 


Microstate complete signal. Asserted low and valid only during CLKOUT1 low when the 
TMS320C25 has just com a a memory operation, such as an instruction fetch or a 
data memory read/write. can be used to generate a one wait-state READY signal 
for slow memory. 


Reset input. Causes the TMS320C25 to terminate execution and forces the program 
counter to zero. When brought to a high level, execution begins at location zero of 
program memory. RS affects various registers and status bits. 


XF External flag output (latched software-programmable signal). Used for signalling other 
processors in multiprocessor configurations or as a general-purpose output pin. 


SUPPLY/OSCILLATOR SIGNALS 
CLKOUT1 Master clock output signal (CLKIN frequency/4). Rises at the beginning of quarter-phase 
3 (Q3) and falls at the beginning of quarter-phase 1 (Q1). 
CLKOUT2 A second clock output signal. Rises at the beginning of quarter-phase 2 (Q2) and falls 
at beginning of quarter-phase 4 (Q4). 


Four 5-V supply pins, tied together externally. 


82 
10 Three ground pins, tied together externally. 
27 
44 
X1 Output pin from the internal oscillator for the crystal. If a crystal is not used, this pin 
should be left unconnected. 
X2/CLKIN Input pin to the internal oscillator from the crystal. If a crystal is not used, a clock may 
be input to the device on this pin. 


SERIAL PORT SIGNALS 


Receive clock input. External clock signal for clocking data from the DR (data receive) 
pin into the RSR (serial port receive shift register). Must be present during serial port 
transfers. 


Transmit clock input. External clock signal for clocking data from the XSR (serial port 
transmit shift register) to the DX (data transmit) pin. Must be present during serial port 
transfers. 


Serial data receive input. Serial data is received in the RSR (serial port receive shift 
register) via the DR pin. 


Serial data transmit output. Serial data transmitted from the XSR (serial port transmit shift 
register) via the DX pin. Placed in high-impedance state when not transmitting. 


Frame synchronization pulse for receive input. The falling edge of the FSR pulse initiates 
the data-receive process by gating the clock for receive (CLKR) input to the DRR (serial 
port data receive register), and beginning the clocking of the RSR. 


Frame synchronization pulse for transmit input/output. The falling edge of the FSX pulse 
initiates the data-transmit process by gating the clock for transmit (CLKX) input to the 
shift register associated with DXR (serial port data transmit register), and beginning the 
clocking of the XSR. The FSX is normally an input, but this pin is an output when the 
TXM in the status register is set to 1. 


T Input/Output/High-impedance state 
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2.3 Memory 


The TMS320C25 provides a total of 544 16-bit words of on-chip data RAM, which 
is divided into three separate blocks (BO, B1, and B2). Of the 544 words, 256 words 
(block BO) are configurable as either data or program memory by CNFD or CNFP 
instructions provided for that purpose; 288 words (blocks B1 and B2) are always 
data memory. A data memory size of 544 words allows the TMS320C25 to handle 
a data array of 512 words while still leaving 32 locations for intermediate storage. 
The TMS320C25 provides 64K words of off-chip directly addressable data memory 
space. 


The TMS320C25 is equipped with a 4096-word on-chip ROM that can be mask- 
programmed at the factory with a customer’s program. The ROM may be mapped 
in or out of the TMS320C25’s memory space by an external pin on the device, 
MicroProcessor/MicroComputer select (MP/MC). This permits the designer to 
accelerate time-to-market with a TMS320C25-based product by using external ROM, 
and cost-reducing it later with the large 4K internal ROM on the device without any 
PC-board redesign. The TMS320C25 provides 64K words of off-chip program 
memory space in which programs can be executed at full speed with sufficiently fast 
memory or with wait states inserted for slower memories. Block BO may also be used 
aS program memory. Instructions can be downloaded from slow (inexpensive) 
external program memory by using block repeats from program to data memory 
(RPTK and BLKP). The block can then be configured as program memory using the 
CNFP instruction. In this way, small time-critical blocks of program memory can 
be stored inexpensively yet executed at full speed. 


The TMS320C25 provides three separate address spaces for program memory, data 
memory, and I/O. In addition to blocks BO, B1, and B2, the data memory map (see 
Figure 2-3) includes the memory-mapped registers and reserved locations. Six 
peripheral registers including the serial port registers, timer register, period register, 
interrupt mask register, and global memory allocation register have been mapped into 
the data memory space for easy modification. Reserved locations may not be used 
for storage, and their contents are undefined when read. 
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Figure 2-3. TMS320C25 Memory Maps 
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The TMS320C25 provides a register file containing eight Auxiliary Registers 
(ARO-AR7), which may be used for indirect addressing of data memory or for 
temporary storage. These registers may be either directly addressed by an instruction 
or indirectly addressed by a three-bit Auxiliary Register Pointer (ARP). The auxiliary 
registers and the ARP may be loaded from either data memory or by an immediate 
operand defined in the instruction. The contents of these registers may also be stored 
into data memory. 


The auxiliary register file is connected to the Auxiliary Register Arithmetic Unit 
(ARAU). The ARAU may autoindex the current auxiliary register while the data 
memory location is being addressed. Indexing by either +/-1 or the contents of ARO 
may be performed. As a result, accessing tables of information does not require the 
CALU for address manipulation, thus freeing it for other operations. 


Although the ARAU is useful for address manipulation in parallel with other oper- 
ations, it may also serve as an additional general-purpose arithmetic unit since the 
auxiliary register file can directly communicate with data memory. The ARAU 
implements 16-bit unsigned arithmetic, whereas the CALU implements 32-bit 
two’s-complement arithmetic. Branches dependent on the comparison of ARO with 
the auxiliary register pointed to by ARP are also provided. 


The TMS320C25 contains a 16-bit Program Counter (PC), a 16-bit Prefetch Counter 
(PFC), a MicroCall Stack (MCS) register, and an eight-level hardware stack for PC 
storage. The program counter contains the address of the currently executing 
instruction, either on-chip or off-chip, and the prefetch counter is used for fetching 
instructions. The eight-level stack is used during interrupts and subroutines, and the 
MCS is used to store the contents of the PFC during BLKD/BLKP, MAC/MACD, 
and TBLR/TBLW instructions. 


The contents of the accumulator may be loaded into the PC in order to implement 
“computed go to” operations. The TMS320C25 includes push and pop instructions 
for nesting of subroutines/interrupts beyond eight levels by allowing a stack to be 
built in data memory. These instructions store the top of the stack into data memory 
or load it into the accumulator. 


The TMS320C25 local memory interface consists of a 16-bit parallel data bus 
(D15-D0), a 16-bit program address bus (A15-A0O), three pins for data/program 
memory or |/O space select (DS, PS, and IS), and various system control signals. 
The R/W signal controls the direction of a data transfer, and STRB provides a timing 
signal to control the transfer. When using on-chip program RAM, ROM, or high- 
speed external program memory, the TMS320C25 runs at full speed without wait 
states. The use of a READY signal allows wait-state generation for communicating 
with slower off-chip memories. 


The TMS320C25 supports Direct Memory Access (DMA) to its external 
program/data memory using the HOLD and HOLDA signals. Another processor can 
take complete control of the TMS320C25’s external memory by asserting HOLD low. 
This causes the TMS320C25 to place its address, data, and control lines in the 
high-impedance state. Signaling between the external processor and the 
TMS320C25 can be performed using interrupts. Two modes are available on the 
device. In the TMS32020-like mode, execution is suspended during assertion of 
HOLD. In the new “concurrent DMA” mode, the TMS320C25 continues to execute 
its program while operating from internal RAM or ROM, thus greatly increasing 
throughput in data-intensive applications. 
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2.4 Central Arithmetic Logic Unit (CALU) 


The TMS320C25 CALU contains a 16-bit scaling shifter, a 16 x 16-bit parallel 
multiplier, a 32-bit Arithmetic Logic Unit (ALU), a 32-bit accumulator, and some 
additional scalers available at the outputs of both the accumulator and the multiplier. 


The following steps occur in the implementation of a typical ALU instruction: 


1) Data is fetched from the RAM on the data bus, 

2) Data is passed through the scaling shifter and the ALU where the arithmetic is 
performed, and 

3) The result is moved into the accumulator. 


One input to the ALU is always provided from the accumulator, and the other input 
may be transferred from the Product Register (PR) of the multiplier or the scaling 
shifter which is loaded from data memory. 


The TMS320C25 scaling shifter has a 16-bit input connected to the data bus and a 
32-bit output connected to the ALU. The scaling shifter produces a left-shift of 0 
to 16 bits on the input data, as programmed in the instruction. The LSBs of the output 
are filled with zeros, and the MSBs may be either filled with zeros or sign-extended, 
depending upon the state of the sign-extension mode bit of status register ST1. 
Additional shift capabilities enable the processor to perform numerical scaling, bit 
extraction, extended arithmetic, and overflow prevention. 


The TMS320C25 32-bit ALU and accumulator perform a wide range of arithmetic 
and logical instructions, the majority of which execute in a single clock cycle. The 
overflow saturation mode may be programmed through the SOVM and ROVM 
(set/reset overflow mode) instructions. When the accumulator is in the overflow 
saturation mode and an overflow occurs, an overflow flag is set and the accumulator 
is loaded with the most positive/negative number depending upon the direction of 
overflow. 


The 32-bit accumulator is split into two 16-bit segments for storage in data memory: 
ACCH (accumulator high) and ACCL (accumulator low). Additional shifters at the 
output of the accumulator provide a shift of 0 to 7 places to the left. This shift is 
performed while the data is being transferred to the data bus for storage. The contents 
of the accumulator remain unchanged. The accumulator also has an in-place one-bit 
shift to the left or right (SFL or SFR instructions) and rotate through carry (ROL or 
ROR instructions) for shifting the contents of the accumulator. 


A carry bit has been added to the TMS320C25 to facilitate multiple-precision arith- 
metic. The carry bit is affected by all add and subtract instructions. Two new 
instructions, ADDC (add with carry) and SUBB (subtract wth borrow), use the carry 
bit when computing a result. 


The TMS320C25 utilizes a 16 x 16-bit hardware multiplier, which is capable of 
computing a 32-bit product during every machine cycle. Two registers are associated 
with the multiplier: 


@ A 16-bit Temporary Register (TR) that holds one of the operands for the 
multiplier, and 
@ A 32-bit Product Register (PR) that holds the product. 


The output of the product register can be left-shifted 1 or 4 bits. This is useful for 
implementing fractional arithmetic or justifying fractional products. The output of the 
PR can also be right-shifted 6 bits to enable the execution of up to 128 consecutive 
multiply/accumulates without overflow. 


An unsigned multiply (MPYU) instruction facilitates extended-precision multipli- 
cation. The unsigned contents of the T register are multiplied by the unsigned 
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2.5 System 


contents of the addressed data memory location, with the result placed in the P 
register. 


Two multiply/accumulate instructions (MAC and MACD) fully utilize the computa- 
tional bandwidth of the multiplier, allowing both operands to be processed simul- 
taneously. For MAC and MACD, two operands are transferred to the multiplier each 
cycle via the program and data buses. This provides for single-cycle 
multiply/accumulates when used with repeat (RPT or RPTK) instructions. The 
program bus can supply data from internal or external memory (RAM or ROM) and 
still maintain single-cycle operation. The SQRA (square/add) and SQRS 
(square/subtract) instructions pass the same value to both inputs of the multiplier 
for squaring a data memory value. 


The TMS320C25 supports floating-point operations for applications requiring a large 
dynamic range. A normalization (NORM) instruction is used to normalize fixed-point 
numbers contained in the accumulator by performing left shifts. The LACT (load 
accumulator with shift specified by the T register) instruction denormalizes a float- 
ing-point number by arithmetically left-shifting the mantissa through the input 
scaling shifter. The ADDT and SUBT instructions have also been provided to allow 
additional arithmetic operations with shift specified by the T register. Floating-point 
numbers with 16-bit mantissas and 4-bit exponents can thus be manipulated. 


The device has a variety of branch instructions that are interpreted according to the 
status of the ALU. Bit test instructions (BIT and BITT) have also been included, 
which do not affect the accumulator but allow the testing of a specified bit of a word 
in data memory. 


Control 


Control operations are provided on the TMS320C25 by an on-chip timer, a repeat 
counter, three external maskable user interrupts, and internal interrupts generated 
by serial port operations or by the timer. 


The TMS320C25 provides a memory-mapped 16-bit timer (TIM) register that is a 
down counter continuously clocked by CLKOUT1. A timer interrupt (TINT) is 
generated whenever the timer decrements to zero. The timer is reloaded with the value 
contained in the period (PRD) register within the next cycle after it reaches zero so 
that interrupts may be programmed to occur at regular intervals of (PRD + 1) x 
CLKOUT1 cycles. This feature is useful for control operations and for synchronously 
sampling or writing to peripherals. 


The TMS320C25 design includes a repeat feature that allows a single instruction to 
be performed up to 256 times. The repeat counter (RPTC) is loaded with either a 
data memory value (in the case of the RPT instruction) or an immediate value (in 
the case of the RPTK instruction). The repeat feature can be used with instructions 
such as multiply/accumulates, block moves, |/O transfers, and table read/writes. 
Those instructions that are normally multicycle are pipelined when using the repeat 
feature, and effectively become single-cycle instructions. For example, the table read 
(TBLR) instruction ordinarily takes four cycles, but when repeated, a table location 
can be read every cycle. 


The TMS320C25 has three external maskable user interrupts (INT2-INTO) available 
for external devices that interrupt the processor. Internal interrupts are generated 
by either the serial port, the timer, or the software interrupt instruction. Interrupts 
are prioritized with reset having the highest priority and the serial port transmit 
interrupt having the lowest priority. 
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The conditions and modes of the TMS320C25 are stored in the two status registers, 
STO and ST1. Instructions allow for storing and loading the status registers into and 
from data memory. In this manner, the current status of the device may be saved 
during interrupts and subroutine calls. 


2.6 1|/O Interface 


The TMS320C25 supports a wide range of system interfacing requirements. Three 
separate address spaces (program, data, and |/O) provide interfacing to memory and 
|/O, thus maximizing system throughput. |/O design is simplified by having |/O 
treated the same way as memory. |/O devices are mapped into the I/O address space 
using the processor’s external address and data buses in the same manner as 
memory-mapped devices. Interfacing to memory and |/O devices of varying speeds 
is accomplished by using the READY line. 


The TMS320C25 |/O space consists of 16 input and 16 output ports. These ports 
provide the full 16-bit parallel |/O interface via the data bus on the device. A single 
input or output operation typically takes two cycles; however, when used with the 
repeat counter, the operation becomes single-cycle. 


An on-chip serial port provides direct communication with serial devices such as 
codecs, serial A/D converters, and other serial systems. The interface signals are 
compatible with codecs and many other serial devices with a minimum of external 
hardware. The two serial port memory-mapped registers (the data transmit/receive 
registers) may be operated in either an 8-bit byte or 16-bit word mode. The transmit 
framing synchronization pulse can be generated internally or externally. The maxi- 
mum speed of the serial port is 5 MHz. 


The primary enhancements of the TMS320C25’s serial port over the TMS32020 are: 


& Double-buffering for both receive and transmit operations, thus allowing a 
continuous bit stream even if FSX is an output, 

@ No minimum CLKR/CLKX frequency (fmin = 0 Hz), and 

* Frame sync mode (FSM) bit, which allows continuous operation with no frame 
synchronization pulses. 


The frame sync mode is useful in communicating to "PCM highways.” For AT&T 
T1 and CCITT G711/712 lines, the TMS320C25 can easily be made to communicate 
directly in these formats by counting the transmitted/received bytes in software and 
performing SFSM/RFSM instructions as needed to set/reset the FSM bit. 


2.7 System Configurations 


The flexibility of the TMS320C25 allows configurations to satisfy a wide range of 
system requirements. The TMS320C25 can be used as follows: 


@ A standalone system (a single processor using 4K words of on-chip ROM and 
544 words of on-chip RAM), 

e Parallel multiprocessing systems with shared global data memory, or 

* Host/peripheral coprocessing using interface control signals. 


The standalone hardware system interface consists of a 16-bit parallel data bus, a 
16-bit address bus, three pins for memory space select, and various system control 
signals. In Figure 2-4, an external data RAM and a PROM/EPROM have been added 
to the minimum processing system. The READY signal allows wait-state generation 
for communicating with slower off-chip memories. All the memories and |/O devices 
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are directly controlled by the TMS320C25, thus minimizing external hardware 
requirements. 
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Figure 2-4. A Minimum Processing System 


The serial port can interface to serial devices such as codecs and serial A/D 
converters. Serial communication can also be used between processors, e.g., to 
connect two minimal systems together to make a multiprocessing system. 


For multiprocessing applications, the TMS320C25 has the capability of allocating 
global data memory space and communicating with that space via the BR (bus 
request) and READY control signals. The 8-bit memory-mapped global memory 
allocation register (GREG) specifies up to 32K words of the TMS320C25’s data 
memory as global external memory. The contents of the register determine the size 
of the global memory space. If the current instruction addresses an operand within 
that space, BR is asserted to request control of the bus. The length of the memory 
cycle is controlled by the READY line. 


In a multiprocessing system using global memory, the address space of each 
processor is divided into local and global sections. Global memory can be used for 
common data memory storage. 


Figure 2-5 shows a configuration for a parallel processing system using global 
memory. Two TMS320C25s share a global data memory while executing from local 
program memory. The arbitration for the global memory is handled in software by 
using the XF and BIO pins. The XF pin acts as an external flag, and the BIO pin can 
be polled by a branch (BIOZ) instruction whose condition depends on the state of 
BIO. 
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Figure 2-5. Global Memory Parallel Processing 


Multiprocessing with the TMS320C25 may also be accomplished through the use 
of two sets of interface control signals: HOLD/HOLDA and interrupts. HOLD/HOLDA 
(hold/hold acknowledge) signals allow another microprocessor to read from or write 
to the local off-chip data/program memory of the temporarily halted processor. Using 
these signals to implement direct memory access is useful for downloading to or 
initializing the TMS320C25. In interrupt-driven multiprocessing, time-critical oper- 
ations can be protected by masking out interrupts. 


The TMS320C25 has been enhanced to provide a new hold mode that provides the 
ability to perform concurrent DMA. The new hold mode has been defined so that if 
the device is executing from on-chip program memory (ROM or RAM) and HOLD 
is asserted, the device is not halted, but instead proceeds with program execution 
until an external access must be made. This greatly enhances system throughput in 
multiprocessing applications. 


Many applications require a digital signal processing-type peripheral interface to a 
general-purpose 16- or 16/32-bit microcomputer. Such configurations are often 
useful when a general-purpose system is already available. A host/peripheral 
configuration using the interface control signals of HOLD/HOLDA is shown in Figure 
2-6. 
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Figure 2-6. Host/Peripheral Coprocessing Using Interface Control Signals 


A great advantage to using the TMS320C25 in a multiprocessor system is its ability 
to be synchronized to an external signal. A special SYNC pin allows the internal clocks 
of two or more TMS320C25s to be synchronized. Since the processors operate on 
the same internal clock phase, all external signals will also be synchronized, elimi- 
nating the need for external logic to synchronize interprocessor signals. 


2.8 Addressing Modes and Instructions 


The TMS320C25 instruction set supports numeric-intensive signal processing 
operations as well as general-purpose applications such as multiprocessing and 
high-speed control. The TMS320C25 is completely object code upward-compatible 
with the TMS32020 so that TMS32020 programs run unmodified on the 
TMS320C25. The TMS32010 source code is upward-compatible with the 
TMS320C25 source code. 


For maximum throughput, the current instruction is executed while the next 
instruction is decoded and the one following that is prefetched. Since the same data 
lines are used to communicate to external data/program or |/O space, the number 
of cycles may vary depending upon whether the next data operand fetch is from 
internal or external memory. Highest throughput is achieved by maintaining data 
memory on-chip and using either internal or fast external program memory. 
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Three memory addressing modes are available with the TMS320C25 instruction set: 
direct, indirect, and immediate addressing. Both direct and indirect addressing can 
be used to access data memory. When using direct addressing, seven bits of the 
instruction word are concatenated with the nine bits of the Data memory page Pointer 
(DP) to form the 16-bit data memory address. With a 128-word page length, the 
DP register points to one of 512 possible data memory pages to obtain a 64K total 
data memory space. The seven-bit address in the instruction points to the specific 
location within the data memory page. Direct addressing can be used with all 
instructions except CALL, the branch instructions, immediate operand instructions, 
and instructions with no operands. 


Flexible and powerful indirect addressing is provided by the eight auxiliary registers 
(ARO-AR7). The data address to be used in an instruction is placed into one of eight . 
auxiliary registers. To select a specific auxiliary register, the Auxiliary Register Pointer 
(ARP) is loaded with a value from O through 7, designating ARO through AR7, 
respectively. The ARAU implements 16-bit unsigned arithmetic, performing auxiliary 
register arithmetic operations in the same cycle as the execution of the instruction. 


There are seven types of indirect addressing: indexing with either increment or 
decrement, indexing by either adding or subtracting the contents of ARO, indexing 
by either adding or subtracting the contents of ARO with the carry propagation 
reversed (for FFTs), or no indexing (see Table 2-2). All indexing operations are 
performed on the current auxiliary register in the same cycle as the original instruction, 
with an optional new ARP value being loaded. 


Bit-reversed indexed addressing modes allow efficient |/O to be performed for the 
resequencing of data points in a radix-2 FFT program. The direction of carry propa- 
gation in the ARAU is reversed when this mode is selected and ARO is added 
to/subtracted from the current auxiliary register. Typical use of this addressing mode 
requires that ARO first be set to a value corresponding to one-half of the array size, 
and AR (ARP) be set to the base address of the data (the first data point). 


Table 2-2. Addressing Modes 


ADDRESSING MODE OPERATION 


OPA Direct addressing 

OP *(,NARP) Indirect; no change to AR. 

OP *+(,NARP) Indirect; current AR is incremented. 
OP *-(,NARP) Indirect; current AR is decremented. 


OP *0+(,NARP) Indirect; ARO is added to current AR. 

OP *0-(,NARP) Indirect; ARO is subtracted from current AR. 

OP *BRO+(,NARP) Indirect; ARO is added to current AR (with 
reverse Carry propagation). 

OP *BRO-(,NARP) Indirect; ARO is subtracted from current AR 
(with reverse carry propagation). 


NOTE: The optional NARP field specifies a new value of the ARP. 


In immediate addressing, the instruction word contains the value of the immediate 
operand. The TMS320C25 has both single-word (8-bit and 13-bit constant) short 
immediate instructions and two-word (16-bit constant) long immediate instructions. 
In the case of long (16-bit constant) immediate instructions, the word following the 
instruction opcode is used as the immediate operand. Included in the TMS320C25’s 
instruction set are 17 immediate operand instructions. 


Table 2-3 defines the symbols and abbreviations used in the operation portion of the 
list of TMS320C25 instructions (Table 2-4). 


Architectural Overview 


Table 2-3. Instruction Symbols 


iat ee ee 


Accumulator 

Auxiliary register pointer buffer 

Auxiliary Register n (ARO through AR7 are predefined 
assembler symbols equal to 0 through 7, respectively.) 
Auxiliary register pointer 

Branch control input 

Carry bit 

2-bit field specifying compare mode 

On-chip RAM configuration control bit 

Data memory address 

Data page pointer 

Format status bit 

Frame synchronization mode bit 

Hold mode bit 

Interrupt mode flag bit 

Indicates nn is a hexadecimal number. (All others are 
assumed to be decimal values.) 

Overflow flag bit 

Overflow mode bit 

Product register 

Port address. (PAO through PA15 are predefined assembler 
symbols equal to 0 through 15, respectively.) 
Program counter 

2-bit field specifying P register output shift code 
Program memory address 

Product register 

Repeat counter 

Status Register n (STO or ST1) 

Sign-extension mode bit 

Temporary register 

Test control bit 

Top of stack 

Temporary register 

Transmit mode bit 

Unsigned value 

XF pin status bit 

Is assigned to 

An absolute value 

Optional items 

Contents of 


Twenty-four new instructions have been added to the TMS320C25 instruction set 
to improve overall processor throughput and ease of use. These new instructions can 
be categorized into the following four groups: 


Extended-precision arithmetic (ADDC, SUBB, MPYU, BC, BNC, SC, RC) 
Adaptive filtering (MPYA, MPYS, ZALR) 

Control and I/O (SHM, RHM, STC, RTC, SFSM, RFSM) 

Accumulator and register instructions (SPH, SPL, ADDK, SUBK, ADRK, SBRK, 
ROL, ROR) 


The list of TMS320C25 instructions in Table 2-4 is organized according to function 
and alphabetized within each functional grouping. The symbol (T) indicates 
instructions that are not included in the TMS32010 instruction set, and the symbol 
(+) those not included in the TMS32020 instruction set. 


Architectural Overview 


Table 2-4. TMS320C25 Instructions 


ACCUMULATOR MEMORY REFERENCE INSTRUCTIONS 


NO. 
DESCRIPTION OPERATION 
Wei a WORDS 


ABS Absolute value of accumulator \(ACC)| - ACC 


ADD Add to accumulator with shift (ACC) + [(dma) x 2shift] = ACC 
ADDCc# Add to accumulator with carry (ACC) + (dma) + (C) ~ ACC 
ADDH Add to high accumulator (ACC) + [(dma) x 216] + ACC 
ADDK#+ Add to accumulator short immediate (ACC) + 8-bit constant ~ ACC 
ADDS Add to low accumulator with sign (ACC) + (dma) ~ ACC 


extension suppressed 


AbDpTt Add to accumulator with shift specified by (ACC) + [(dma) x 2(Treg)} — ACC 
T register 
ADLKtT Add to accumulator long immediate with shift (ACC) + [16-bit constant x 2shift) + ACC 


AND (ACC(15-0)). AND. (dma) ~ ACC(15-0), 
0 > ACC(31-16) 
(ACC)30-0)). AND.[16-bit constant x 2shift) s 


ACC(30-0), 0 ~ ACC(30-0) 


AND with accumulator 


ANDKt AND immediate with accumulator with shift 


CMPLt Complement accumulator 1 (ACC) > ACC 

LAC Load accumulator with shift 1 (dma) x 2shift — ACC 

LACK Load accumulator immediate short 1 8-bit constant ~ ACC 

LACTT Load accumulator with shift specified by T register 1 (dma) x 2(Treg) — ACC 

LALKT Load accumulator long immediate with shift 2 (16-bit constant) x 216 > ACC 

NEGt Negate accumulator 1 —(ACC) ~ ACC 

NORMt Normalize contents of accumulator 1 

OR OR with accumulator 1 (ACC(15-0)).OR. (dma) —~ ACC(15-0) 

ORKt OR immediate with accumulator with shift 2 (ACC(30-0)).OR.[16-bit constant x 2shift) | 


ACC(30-0) 

(ACC(30-0)) ~ ACC(31-1), (C) ~ ACC(O), 
(ACC(31)) = C 

(ACC(31-1)) ~ ACC(30-0), (C) ~ ACC(31), 
(ACC(O)) > C 


ROL? Rotate accumulator left 


ROR+ Rotate accumulator right 


SACH Store high accumulator with shift 1 ((ACC) x 2shift) — dma 

SACL Store low accumulator with shift 1 [((ACCL) x 2shift] — dma 

SBLKT Subtract from accumulator long immediate with shift 2 (ACC) — [16-bit constant x 2shift] - ACC 
SFLT Shift accumulator left 1 (ACC(30-0)) + ACC(31-1), 0 + ACC(O) 
SFRt Shift accumulator right 1 (ACC(31-1)) ~ ACC(30-0), (ACC(31)) ~ ACC(31) 
SUB Subtract from accumulator with shift 1 (ACC) — [(dma) x 2shift] + ACC 

SUBBt Subtract from accumulator with borrow 1 (ACC) — (dma) — (C) ~ ACC 

SUBC Conditional subtract 1 

SUBH Subtract from high accumulator 1 (ACC) — [(dma) x 216] — ACC 

SUBK * Subtract from accumulator short immediate 1 (ACC) — 8-bit constant ~ ACC 

SUBS Subtract from low accumulator with sign 1 (ACC) — (dma) ~ ACC 


extension suppressed 


SuBTT Subtract from accumulator with shift specified by (ACC) — [(dma) x 2'Treg)} + ACC 
T register 
XOR Exclusive-OR with accumulator (ACC(15-0)).XOR. (dma) —~ ACC(15-0) 


(ACC(30-0)).XOR.[16-bit constant x 2shift) 
ACC(30-0) 

0 — ACC 

(dma) x 216 > ACC 

(dma) x 216 + >8000— ACC 


XORKT Exclusive-OR immediate with accumulator with shift 


ZAC 
ZALH Zero low accumulator and load high accumulator 


Zero accumulator 


ZALR+ Zero low accumulator and load high accumulator 
with rounding 


ZALS Zero accumulator and load low accumulator with (dma) ~ ACCL, 0 ~ ACCH 


sign extension suppressed 


TThese instructions are not included in the TMS32010 instruction set. 
tThese instructions are not included in the TMS32020 instruction set. 
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Table 2-4. TMS320C25 Instructions (Continued) 


AUXILIARY REGISTERS AND DATA PAGE ——T INSTRUCTIONS 


MNEMONIC DESCRIPTION 


Add to auxiliary register short immediate (ARn) + 8-bit constant — ARn 


Compare auxiliary register with auxiliary register ARO 


Load auxiliary register (dma) — (ARn) 


Load auxiliary register short immediate 8-bit constant ~ ARn 
Load auxiliary register pointer 
(dma) ~ DP 

9-bit constant ~ DP 


16-bit constant ~ ARn 


Load data memory page pointer 

Load data memory page pointer immediate 
Load auxiliary register long immediate 
Modify auxiliary register 


(ARn) — dma 
(ARn) — 8-bit constant ~ ARn 


Store auxiliary register 


wma 


Subtract from auxiliary register short immediate 


lf ARn | CM | ARO, then 1 > TC; else O > TC 


3-bit constant — ARP, (ARP) — ARB 


T REGISTER, P REGISTER, AND aoe INSTRUCTIONS 


! DESCRIPTION PE 
MNEMONIC C O Pra OPERATION 


Add P register to accumulator (ACC) + (shift Preg) ~ ACC 
Load high P register (dma) — Preg (31-16) 
Load T register (dma) > Treg 


Load T register and accumulate previous product (dma) —~ Treg, (ACC) + (shifted Preg) ~ ACC 


Load T register, accumulate previous product, (dma) > Treg, (dma) ~ dma + 1, 
and move data (ACC) + (shifted Preg) ~ ACC 
Load T register and store P register in accumulator (dma) — Treg, (shifted Preg) ~ ACC 


Load T register and subtract previous product (dma) > Treg, (ACC) — (shifted Preg) ~ ACC 


Multiply and accumulate (ACC) + (shifted Preg) ~ ACC, 
(pma) x (dma) > Preg 
Multiply and accumulate with data move (ACC) + (shifted Preg) ~ ACC, 


(pma) x (dma) — Preg, (dma) ~ dma + 1 


Multiply (with T register, store product in P register) (Treg) x (dma) — Preg 
Multiply and accumulate previous product (ACC) + (shifted Preg) ~ ACC, 
(Treg) x (dma) > Preg 


Multiply immediate (Treg) x 13-bit constant — Preg 
Multiply and subtract previous product (ACC) — (shifted Preg) ~ ACC, 
(Treg) x (dma) — Preg 


Multiply unsigned Usgn (Treg) x Usgn (dma) — Preg 

Load accumulator with P register (shifted Preg) ~ ACC 

Subtract P register from accumulator (ACC) — (shifted Preg) ~ ACC 

Store high P register (shifted Preg (31-16)) ~ dma 

Store low P register (shifted Preg (15-0)) — dma 

Set P register output shift mode 2-bit constant —~ PM 

Square and accumulate (ACC) + (shifted Preg) ~ ACC, 
(dma) x (dma) — Preg 

Square and subtract previous product (ACC) — (shifted Preg) ~ ACC, 
(dma) x (dma) — Preg 


tThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 
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Table 2-4. TMS320C25 Instructions (Continued) 


BRANCH/CALL INSTRUCTIONS 


NO. 
OPERATION 


B Branch unconditionally pma — PC 

BAcCT Branch to address specified by accumulator (ACC(15-0)) > PC 

BANZ Branch on auxiliary register not zero If (AR(ARP)) # O, then pma — PC; else (PC) + 2 -- 
PC 

If (TC) = 1, then pma — PC; else (PC) + 2 ~ PC 

If (TC) = O, then pma — PC; else (PC) + 2 > PC 

If (C) = 1, then pma — PC; else (PC) + 2 — PC 

If (ACC) > O, then pma — PC; else (PC) + 2 —~ PC 

lf (ACC) > O, then pma — PC; else (PC) + 2 — PC 

if (BIO) = O, then pma — PC; else (PC) + 2 > PC 

If (ACC) < O, then pma — PC; else (PC) + 2 — PC 

If (ACC) < O, then pma — PC; else (PC) + 2 — PC 

lf (C) = O, then pma — PC; else (PC) + 2 — PC 

If (OV) # O, then pma — PC; else (PC) + 2 — PC 

If (ACC) # O, then pma — PC; else (PC) + 2 — PC 

lf (OV) = O, then pma — PC; else (PC) + 2 — PC 

lf (ACC) = O, then pma — PC; else (PC) + 2 — PC 

(ACC(15-0)) OC, (PC)... 1-2. TOS 

(PC) + 2 > TOS, pma > PC 

(TOS) — PC 


1/0 AND DATA MEMORY OPERATIONS 


NO. 
MNEMONIC DESCRIPTION OPERATION 
- sir tila WORDS ae ee 


Block move from data memory to data memory (dma1, addressed by PC) ~ dma2 
(pma, addressed by PC) — dma 


BBNz? Branch if TC bit + O 

BBzt Branch if TC bit = O 

Bct Branch on carry 

BGEZ Branch if accumulator > O 
BGZ Branch if accumulator > O 
BIOZ Branch on I/O status = O 
BLEZ Branch if accumulator < O 
BLZ Branch if accumulator < O 
BNCt Branch on no carry 

BNVT Branch if no overflow 

BNZ Branch if accumulator 

BV Branch on overflow 

BZ Branch if accumulator 
CALA Call subroutine indirect 
CALL Call subroutine 

RET Return from subroutine 


2 
2 
2 
2 
2 
2 
2 
2 
2 
2 
2 
2 
2 
1 
2 
1 


N 


Block move from program memory to data memory 
(dma) ~ dma + 1 

1-bit constant ~ FO 

(data bus, addressed by PA) > dma 
(dma) — data bus, addressed by PA 

0 > FSM 

0 — TXM 

Gr XF 

1 —> FSM 

1-7 TXM 

1 8 RE 

(pma, addressed by ACC (15-0)) — dma 
(dma) ~ pma, addressed by ACC (15-0) 


Data move in data memory 

Format serial port registers 

Input data from port 

Output data to port 

Reset serial port frame synchronization mode 
Reset serial port transmit mode 

Reset external flag 

Set serial port frame synchronization mode 
Set serial port transmit mode 

Set external flag 

Table read 

Table write 


a ee ee ee ee ee ee | 


tThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 
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Table 2-4. TMS320C25 Instructions (Concluded) 


CONTROL INSTRUCTIONS 


NO. 
MNEMONIC DESCRIPTION 
WORDS OPERATIONS 


BIT Test bit (dma bit at (15-bit code)) ~ TC 
BiTTT Test bit specified by T register (dma bit at (15-Treg)) ~ TC 
CNFDt Configure block as data memory O — CNF 

CNFPt Configure block as program memory 1 — CNF 

DINT Disable interrupt 1—7 INTM 

EINT Enable interrupt 0 -— INTM 

IDLET Idle until interrupt (PC) + 1 + PC, powerdown 
LST Load status register STO (dma) > STO 

LsTit Load status register ST1 (dma) > ST1 

NOP No operation (PC) + 1— PC 

POP Pop top of stack to low accumulator (TOS) ~ ACC 

Poppt Pop top of stack to data memory (TOS) ~ dma 

PSHD?t Push data memory value onto stack (dma) ~ TOS 

PUSH Push low accumulator onto stack (ACCL) ~ TOS 

RCt Reset carry bit 0o-C 

RHM# Reset hold mode 0—- HM 

ROVM Reset overflow mode 0 — OVM 

RPTt Repeat instruction as specified by data memory value (dma) ~ RPTC 

RPTKT Repeat instruction as specified by immediate value 8-bit constant ~ RPTC 
RSXMt Reset sign-extension mode O — SXM 

RTCt Reset test/control flag 0-TC 

sct Set carry bit con & 

SHM# Set hold mode 1—- HM 

SOVM Set overflow mode 1—- OVM 

SST Store status register STO STO — dma 

ssTit Store status register ST1 ST1 — dma 

ssxmt Set sign-extension mode 1 —- SXM 

sTct Set test/control flag tee TC , 
TRAPT Software interrupt (PC) + 1 > TOS, 30 > PC 


tThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 
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2.9 Development Support 


Texas Instruments offers extensive development support and documentation for the 
TMS320 family (see Figure 2-7). Sophisticated development operations are 
performed with the TMS320C25 Macro Assembler/Linker, Simulator, and Emulator 
to evaluate the performance of the processor, develop algorithms, and fully integrate 
the design’s software and hardware modules. Since the TMS320C25 is pin-com- 
patible with the TMS32020, development can begin immediately by utilizing the 
broad base of TMS32020 support tools (see Appendix F). 


Extensive documentation, including application reports, user’s guides, and textbooks, 
is available to support DSP design, research, and education. When questions arise, 
additional support can be obtained by contacting the Texas Instruments Customer 
Response Center (CRC) hotline number, 1-800-232-3200. 


Figure 2-7. TMS320 Family Development Support 
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TMS320C25 MACRO ASSEMBLER/LINKER 


The TMS320C25 Macro Assembler translates TMS320C25 assembly language 
source code into executable object code. The assembler allows the programmer to 
work with mnemonics rather than hexadecimal machine instructions and to reference 
memory locations with symbolic addresses. The macro assembler supports macro 
calls and definitions along with conditional assembly. 


The TMS320C25 Linker permits a program to be designed and implemented in 
separate modules that will later be linked together to form the complete program. 
The linker resolves external definitions and references for relocatable code, creating 
an object file that can be executed by the TMS320C25 Simulator, TMS320C25 
Emulator, or TMS320C25 processor. 


The TMS320C25 Macro Assembler/Linker is supported on the VAX/VMS, TI 
PC/MS-DOS, and IBM PC/PC-DOS operating systems. 


TMS320C25 SIMULATOR 


The TMS320C25 Simulator is a software program that simulates operation of the 
TMS320C25 to allow program verification. The debug mode enables the user to 
monitor the state of the simulated TMS320C25 while the program is executing. The 
simulator uses the TMS320C25 object code produced by the TMS320C25 Macro 
Assembler/Linker. During program execution, the internal registers and memory of 
the simulated TMS320C25 are modified as each instruction is interpreted by the host 
computer. Once program execution is suspended, the internal registers and both 
program and data memories can be inspected and/or modified. 


The TMS320C25 Simulator is supported on the VAX/VMS, Tl PC/MS-DOS, and IBM 
PC/PC-DOS operating systems. 


TMS320C25 EMULATOR 


The TMS320C25 Emulator (XDS/22) is a user-friendly system that has all the 
features necessary for realtime in-circuit emulation. This allows integration of the 
hardware and software modules in the debug mode. By setting breakpoints based 
on internal conditions or external events, execution of the program can be suspended 
and control given to the debug mode. In the debug mode, all registers and memory 
locations can be inspected and modified. Single-step execution is available. Full 
trace capabilities at full speed and a reverse assembler that translates machine code 
back into assembly instructions also increase debugging productivity. 


The TMS320C25 Emulator is a completely self-contained system. With three 
RS-232-C ports, it can be interfaced to a terminal, host computer for source or object 
downloading/uploading capabilities, and printer or PROM programmer. The 
emulator has 4K x 16-bit words of high-speed static RAM (zero wait states) for 
program memory. The XDS/22 also supports memory expansion by including 64K 
words of DRAM. This slower memory is configurable by the user as either all program 
memory, all data memory, or 32K words of each. 
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The TMS320C25 microprocessor architectural design emphasizes overall speed, 
communication, and flexibility in processor configuration. Control signals and 
instructions provide block-memory transfers, communication to slower off-chip 
devices, and multiprocessing implementations. Increased throughput for many digital 
signal processing (DSP) applications is accomplished’ by single-cycle 
multiply/accumulate instructions, two large on-chip RAM blocks, eight auxiliary 
registers with a dedicated arithmetic unit, a serial port, hardware timer, faster |/O for 
data-intensive signal processing, and many other features. Figure 2-1 shows the 
functional block diagram of the TMS320C25 processor. 


Major topics discussed in this section are listed below. 
@ Internal Hardware Summary (Section 3.1 on page 3-3) 


@ Memory Organization (Section 3.2 on page 3-5) 
On-chip program ROM 
On-chip data RAM blocks 
Memory maps 
Memory-mapped registers 
Auxiliary registers 
Addressing modes 
Memory-to-memory moves 


@ Central Arithmetic Logic Unit (CALU) (Section 3.3 on page 3-13) 
Scaling shifter 
ALU and accumulator 
Multiplier, T and P registers 


@ System Control (Section 3.4 on page 3-18) 
Program counter and related hardware 
Reset 
Status registers 
Timer operation 
Repeat counter 
Powerdown mode 


Ea External Memory and I/O Interface (Section 3.5 on page 3-26) 
Internal clock timing relationships 
External read and write cycles 
Wait states 


@ Interrupts (Section 3.6 on page 3-31) 
Interrupt operation 
External interrupt interface 


@ = Serial Port (Section 3.7 on page 3-35) 
Transmit and receive operations 


# Multiprocessing and Direct Memory Access (Section 3.8 on page 3-44) 
Synchronization 
Global memory 
The hold function 


@ General-Purpose |/O Pins (Section 3.9 on page 3-49) 


BIO input 
External flag output 
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Figure 3-1. TMS320C25 Block Diagram 
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3.1 Internal Hardware Summary 


The TMS320C25 internal hardware implements functions that other processors 
typically perform in software or microcode. For example, the device contains 
hardware for single-cycle 16 x 16-bit multiplication, data shifting, and address 
manipulation. This hardware-intensive approach provides computing power previ- 
ously unavailable on a single chip. 


Table 3-1 presents a summary of the TMS320C25 internal hardware. This summary 
table, which includes the internal processing elements, registers, and buses, is 
alphabetized within each functional grouping. All of the symbols used in this table 
correspond to the symbols used in the block diagram of Figure 3-1, the succeeding 
block diagrams in this section, and the text throughout this document. 


Table 3-1. Internal Hardware 


UNIT SYMBOL FUNCTION 
PROCESSING ELEMENTS 

Arithmetic Logic Unit ALU A 32-bit two’s-complement arithmetic logic unit having two 32-bit input ports 

and one 32-bit output port feeding the accumulator. 

MULT A 16 x 16-bit parallel multiplier. 

PRD (15-0) | A 16-bit memory-mapped register used to reload the timer. 

PC (15-0) A 16-bit program counter used to address program memory. The PC always 
contains the address of the next instruction to be executed. The PC contents 
are updated following each instruction decode operation. 

PFC (15-0) 
when using the block move (BLKD and BLKP), multiply/accumulate (MAC 
and MACD), and table read/write (TBLR and TBLW) instructions. 
Random Access Memory | RAM (BO) A RAM block with 256 x 16 locations configured either as data or program 
(data or program) memory. 7 


Random Access Memory | RAM (B2) A data RAM block, organized as 32 x 16 locations. 
(data only) / 
Auxiliary Register ARAU A 16-bit unsigned arithmetic unit used to perform operations on auxiliary 
Arithmetic Unit register data. 
RPTC (7-0) | An 8-bit counter to control the repeated execution of a single instruction. 
Shifters SFL, SFR Shifters SFL (left) and SFR (right) are located at the ALU input, the accu- 
mulator output, and the product register output. Also an in-place shifter within 
TIM (15-0) A 16-bit memory-mapped timer (counter) for timing control. 


the accumulator. 
ACC (31-0) A 32-bit accumulator split in two halves: ACCH (accumulator high) and 


ACCH(31-16)| ACCL (accumulator low). Used for storage of ALU output. 
Auxiliary Register File 


Period Register 


Program Counter 


A 16-bit counter used to prefetch program instructions. The PFC contains the 
address of the instruction currently being prefetched. The PFC is updated 
when a new prefetch is initiated. The PFC is also used to address data memory 


Prefetch Counter 


ACCL(15-0) 


ARO,AR1,AR2] A register file containing 8 16-bit auxiliary registers (ARO-AR7), used for 
AR3,AR4,AR5| addressing data memory, for temporary storage, or for integer arithmetic 
processing through the ARAU. 


Auxiliary Register Pointer | ARP(2-0) A 3-bit register used to select one of the eight auxiliary registers. 
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Table 3-1. Internal Hardware (Continued) 


UNIT SYMBOL FUNCTION 


REGISTERS 


Auxiliary Register Pointer | ARB(2-0) A 3-bit register used to buffer the ARP. Each time the ARP is loaded, the old 

Buffer value is written to the ARB, except during an LST (load status register) 
instruction. When the ARB is loaded with an LST1, the same value is also 
copied into ARP. 

Data Memory Page DP(8-0) A 9-bit register pointing to the address of the current page. Data pages are 


128 words each, resulting in 512 pages of addressable data memory space 
(some locations are reserved). 


Global Memory GREG(7-0) An 8-bit memory-mapped register for allocating the size of the global 
Allocation Register memory space. 
Instruction Register 1R(15-0) A 16-bit register used to store the currently executing 
instruction. 
QIR(15-0) A 16-bit register used to store prefetched instructions. 
Register 


Interrupt Flag Register IFR(5-0) A 6-bit flag register used to latch the active-low external user interrupts 
TNT(2-0) and the internal interrupts XINT/RINT (serial port transmit/receive 
interrupts) and TINT (timer interrupt). The IFR is not accessible through 
software. 


Interrupt Mask Register IMR(5-0) A 6-bit memory-mapped register used to mask interrupts. 


Product Register PR(31-0) A 32-bit product register used to hold the multiplier product. The PR 
PH(31-16) can also be accessed as the most or least significant words using the SPH 
PL(15-0) (store P register high) or SPL (store P register low) instructions, 


Pointer 


Stack Stack(15-0) | An 8 x 16 hardware stack used to store the PC during interrupts or calls. The 


ACCL and data memory values may also be pushed onto and popped from the 
stack. 


MicroCall Stack MCS (15-0) | A single-word stack that temporarily stores the contents of the PFC while the 


PFC is being used to address data memory with the block move (BLKD and 
BLKP), multiply/accumulate (MAC and MACD), and table read/write (TBLR 
and TBLW) instructions. 


Serial Port Data DRR(15-0) A 16-bit memory-mapped serial port data receive register. Only the eight 
Receive Register LSBs are used in the byte mode. 
Serial Port Data DXR(15-0) A 16-bit memory-mapped serial port data transmit register. Only the eight 
Transmit Register LSBs are used in the byte mode. 
Serial Port Receive A 16-bit register used to shift in serial port data from the RX pin. RSR contents 
Shift Register are sent to the DRR after a serial transfer is completed. RSR is not directly 
accessible through software. 
Serial Port Transmit A 16-bit register used to shift out serial port data onto the DX pin. XSR contents 
Shift Register are loaded from DXR at the beginning of a serial port transmit operation. XSR 
is not directly accessible through software. 
Status Registers STO,ST1 Two 16-bit status registers that contain status and control bits. 
(15-0) 
TR(15-0) A 16-bit register that holds either an operand for the multiplier or a shift code 
for the scaling shifter. 
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Table 3-1. Internal Hardware (Concluded) 


Data Memory Address DAB(15-0) A 16-bit bus that carries the data memory address. 
Bus 


Direct Data Memory DRB(15-0) A 16-bit bus that carries the ‘direct’ address for the data memory, which is the 
Address Bus concatenation of the DP register with the seven LSBs of the instruction. 


Program Bus P(15-0) A 16-bit bus used to route instructions (and data for the MAC and MACD 
instructions). 

Program Memory Address} PAB(15-0) A 16-bit bus that carries the program memory address. 

Bus 


3.2 Memory Organization 


The TMS320C25 provides a total of 544 16-bit words of on-chip data RAM and 
4K words of maskable program ROM. Of the 544 words of on-chip data RAM, 288 
are always data memory and the remaining 256 words may be configured as either 
program or data memory. This section explains memory management using the 
on-chip program ROM and data RAM, external memory, memory maps, memory- 
mapped registers, auxiliary registers, data memory addressing, and memory-to-me- 
mory moves. 


3.2.1 On-Chip Program ROM 


The 4K words of on-chip program ROM allow program execution at full speed 
without the need for high-speed external program memory. The use of this memory 
also allows the external data bus to be freed for access of external data memory. In 
addition, there is the added benefit of increased security for the algorithms contained 
in on-chip memory, which may be proprietary. 


Mapping of the first 4K-word block of program memory is user-selectable by means 
of the MP/MC (microprocessor/microcomputer) pin. Setting MP/MC high maps in 
the block of off-chip memory while holding the pin low maps in the block of on-chip 
ROM. The XF (external flag) pin can be used to toggle the MP/MC pin to dynamically 
enable or disable the on-chip ROM. The MP/MC pin is in the location of a VCC pin 
on the TMS32020. This allows substitution of a TMS320C25 for a TMS32020 since 
the TMS320C25 automatically operates in the microprocessor mode and therefore 
is directly compatible in the system. See Section 3.2.3 for the location of the on-chip 
program ROM in the memory map configurations. 
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3.2.2 On-Chip Data RAM Blocks 
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The 544 words of on-chip data RAM are divided into three separate blocks (BO, B1, 
and B2), as shown in Figure 3-2. Of the 544 words, 256 words (block BO) are 
configurable as either data or program memory by instructions provided for that 
purpose; 288 words (blocks B1 and B2) are always data memory. A data memory 
size of 544 words allows the TMS320C25 to handle a data array of 512 words (256 
words if on-chip RAM is used for program memory), while still leaving 32 locations 
for intermediate storage. See Section 3.2.3 for memory map configurations. 


When using block BO as program memory, instructions can be downloaded from 
external program memory using the RPTK (repeat instruction as specified by imme- 
diate value) and BLKP (block move from program memory to data memory) 
instructions. 
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Figure 3-2. On-Chip Data Memory 


When using on-chip program RAM, ROM, or high-speed external program memory, 
the TMS320C25 runs at full speed without wait states. However, the READY line 
can be used to interface the TMS320C25 to slower, less-expensive external memory. 
Downloading programs from slow off-chip memory to on-chip program RAM speeds 
processing while cutting system costs. See Section 3.5 for a description of instruction 
execution using various memory configurations. 
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3.2.3 Memory Maps 


The TMS320C25 provides three separate address spaces for program memory, data 
memory, and I/O, as shown in Figure 3-3. These spaces are distinguished externally 
by means of the PS, DS, and IS (program, data, and |/O space select) signals. The 
on-chip memory blocks BO, B1, and B2 are comprised of a total of 544 words of 
RAM. Program/data RAM block BO (256 words) resides in pages 4 and 5 of the data 
memory map when configured as data RAM and at addresses >FFOO to >FFFF when 
configured as program RAM. Block B1 (always data RAM) resides in pages 6 and 
7, while block B2 resides in the upper 32 words of page O. Note that the remainder 
of page 0 is composed of the memory-mapped registers and reserved locations, and 
pages 1-3 of the data memory map consist of reserved locations. Reserved locations 
may not be used for storage, and their contents are undefined when read. See Section 
3.2.4 for further information on the memory-mapped registers. 


The CNFD/CNFP instructions are used to configure block BO as either data or 
program memory, respectively. The BLKP (block move from program memory to data 
memory) instruction may be used to download program information to block BO 
when it is configured as data RAM, and then a CNFP (configure block as program 
memory) instruction may be used to convert it to program RAM (see the code 
example in Section 5.4.2). 


Reset configures block BO as data RAM. Note that, due to internal pipelining, when 
the CNFD or CNFP instruction is used to remap RAM block BO, there is a delay before 
the new configuration becomes effective. This delay is one fetch cycle if execution 
is from internal program RAM and two fetch cycles if execution is from ROM or 
external program memory. This is particularly important if program execution is from 
the locations around 65280. Accordingly, a CNFP instruction must be placed at 
location 65277 in external memory if execution is to continue from the first location 
in block BO. 


lf a CNFP is placed at location 65278, and the instruction at location 65279 is a 
two-word instruction, the second word of the instruction will be fetched from the 
first location in block BO. If execution is from above location 65280 and block BO 
is reconfigured, care must be taken to assure that execution resumes at the appro- 
priate point in a new configuration. See Section 3.4.1 for a detailed description of 
pipeline operation. 


On-chip program ROM is located in the lower 4K words of program memory when 
selected by setting MP/MC = 0. When MP/MC = 1, the lower 4K words of program 
memory are external. 
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Figure 3-3. Memory Maps 
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3.2.4 Memory-Mapped Registers 


The six registers mapped into the data memory space are listed in Table 3-2 and are 
shown in the block diagram of Figure 3-1. 


The memory-mapped registers may be accessed in the same manner as any other 
data memory location, with the exception that block moves using the BLKD (block 
move from data memory to data memory) instruction cannot be performed from the 
memory-mapped registers. 


Table 3-2. Memory-Mapped Registers 


REGISTER ADDRESS 
NAME LOCATION DEFINITION 


DRR(15-0) Serial port data receive register 


DXR(15-0) Serial port data transmit register 
TIM(15-0) Timer register 

PRD(15-0) Period register 

IMR (5-0) Interrupt mask register 
GREG(7-0) Global memory allocation register 


3.2.5 Auxiliary Registers 


The TMS320C25 provides a register file containing eight auxiliary registers (ARO- 
AR7). This section discusses each register’s function and how an auxiliary register 
is selected and stored. 


The auxiliary registers may be used for indirect addressing of data memory or for 
temporary data storage. Indirect auxiliary register addressing (see Figure 3-4) allows 
placement of the data memory address of an instruction operand into one of eight 
auxiliary registers. These registers are pointed to by a three-bit Auxiliary Register 
Pointer (ARP) that is loaded with a value from 0 through 7, designating ARO through 
AR7, respectively. The auxiliary registers and the ARP may be loaded either from 
data memory or by an immediate operand defined in the instruction. The contents 
of these registers may also be stored in data memory. (Section 4 describes the 
programming of the indirect addressing mode.) 
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Figure 3-4. Indirect Auxiliary Register Addressing Example 


The auxiliary register file (ARO-AR7) is connected to the Auxiliary Register Arithmetic 
Unit (ARAU), shown in Figure 3-5. The ARAU may autoindex the current auxiliary 
register while the data memory location is being addressed. Indexing by either +1 
or by the contents of ARO may be performed. As a result, accessing tables of infor- 
mation does not require the Central Arithmetic Logic Unit (CALU) for address 
manipulation, thus freeing it for other operations. 
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Figure 3-5. Auxiliary Register File 


As shown in Figure 3-5, auxiliary register O (ARQ) or the eight LSBs of the instruction 
registers can be connected to one of the inputs of the ARAU. The other input is fed 
by the current AR (being pointed to by ARP). AR(ARP) refers to the contents of the 
current AR pointed to by ARP. The ARAU performs the following functions: 


AR(ARP) + ARO ~ AR(ARP) _ Index the current AR by adding a 16-bit integer 
contained in ARO. 

AR(ARP) - ARO ~ AR(ARP) _ Index the current AR by subtracting a 16-bit 
integer contained in ARO. 

AR(ARP) +. 1 + AR(ARP) — Increment the current AR by one. 


AR(ARP) - 1 > AR(ARP) Decrement the current AR by one. 

AR(ARP) > AR(ARP) AR(ARP) is unchanged. 

AR(ARP) + IR(7-0) ~ AR(ARP) Add 8-bit immediate value to the current 
AR. 

AR(ARP) -  IR(7-0) ~ AR(ARP) Subtract 8-bit immediate value to the 
current AR. 


AR(ARP) + rcARO ~~ AR(ARP) _ Bit-reversed indexing with reverse-carry 
propagation (see Section 4.1.2). 

AR(ARP) - rcARO ~~ AR(ARP) _ Bit-reversed indexing with reverse-carry 
propagation (see Section 4.1.2). 


Although the ARAU is useful for address manipulation in parallel with other oper- 
ations, it may also serve as an additional general-purpose arithmetic unit since the 
auxiliary register file can directly communicate with data memory. The ARAU 
implements 16-bit unsigned arithmetic, whereas the CALU implements 32-bit 
two’s-complement arithmetic. Instructions provide branches dependent on the 
comparison of the auxiliary register pointed to by ARP with ARO. 


Figure 3-5 also shows the three-bit Auxiliary Register pointer Buffer (ARB) that 
provides storage for the ARP on subroutine calls and interrupts. 
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3.2.6 Addressing Modes 


The TMS320C25 can address a total of 64K words of program memory and 64K 
words of data memory. The on-chip data memory is mapped into the 64K data 
memory space. The memory maps, which change with the configuration of block 
BO, are described in detail in Section 3.2.4. 


The 16-bit Data Address Bus (DAB) addresses data memory in one of the following 
two ways: 


1) By the DiRect address Bus (DRB) using the direct addressing mode (e.g., ADD 
>10), or 


2) By the Auxiliary register File Bus (AFB) using the indirect addressing mode 
(e.g., ADD *). 


Operands are also addressed by the contents of the program counter in the immediate 
addressing mode. 


Figure 3-6 illustrates operand addressing in the direct, indirect, and immediate 
addressing modes. 


INSTRUCTION 
DIRECT ADDRESSING | OPCODE| dma | DP 


NS Ih ION 
INDIRECT ADDRESSING | ARP | 


INSTRUCTION 
IMMEDIATE OPERAND OPERAND PC INSTRUCTION 


PCH 


Figure 3-6. Methods of Instruction Operand Addressing 


If the direct addressing mode is used, the 9-bit Data memory page Pointer (DP) 
points to one of 512 128-word pages. The data memory address (dma), specified 
by the seven LSBs of the instruction, points to the desired word within the page. 
The address on the direct address bus (DRB) is formed by concatenating the 9-bit 
DP with the 7-bit dma. 


When using the indirect addressing mode, the currently selected 16-bit auxiliary 
register AR(ARP) addresses the data memory through the auxiliary register file bus 
(AFB). While the selected auxiliary register provides the data memory address and 
the data is being manipulated by the Central Arithmetic Logic Unit (CALU), the 
contents of the auxiliary register may be manipulated through the Auxiliary Register 
Arithmetic Unit (ARAU). See Figure 3-4 for an example of indirect auxiliary register 
addressing. The direct and indirect addressing modes are described in detail in 
Section 4.1. 


When an immediate operand is used, it is either contained within the instruction word 
itself or, in the case of 16-bit immediate operands, the word following the instruction 
opcode. 
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3.2.7 Memory-to-Memory Moves 


The TMS320C25 provides instructions for data and program block moves and for 
data move functions that efficiently utilize the configurable on-chip RAM. 


The BLKD instruction moves a block within data memory, and the BLKP instruction 
moves a block from program memory to data memory. When used with the repeat 
instructions (RPT and RPTK), the BLKD and BLKP instructions efficiently perform 
block moves from on- or off-chip memory. 


The DMOV (data move) function is useful for implementing algorithms that use the 
z~1 delay operation, such as convolutions and digital filtering where data is being 
passed through a time window. The data move function can be used anywhere 
within blocks BO, B1, or B2. It is continuous across the boundary of blocks BO and 
B1 but cannot be used with off-chip data memory. 


Implemented in on-chip RAM, the DMOV function is equivalent to that of the 
TMS32010 and TMS32020. DMOV allows a word to be copied from the currently 
addressed data memory location in on-chip RAM to the next higher location while 
the data from the addressed location is being operated upon in the same cycle (e.g., 
by the CALU). An ARAU operation may also be performed in the same cycle when 
using the indirect addressing mode. The MACD (multiply and accumulate with data 
move) and the LTD (load T register, accumulate previous product, and move data) 
instructions use the data move function. 


3.3 Central Arithmetic Logic Unit (CALU) 


The TMS320C25 Central Arithmetic Logic Unit (CALU) contains a 16-bit scaling 
shifter, a 16 x 16-bit parallel multiplier, a 32-bit Arithmetic Logic Unit (ALU), a 32-bit 
accumulator (ACC), and additional shifters at the outputs of both the accumulator 
and the multiplier. This section describes the CALU components and their functions. 
Figure 3-7 is a block diagram showing the components of the CALU. 


The following steps occur in the implementation of a typical ALU instruction: 
1) Data is fetched from the RAM on the data bus, 


2) Data is passed through the scaling shifter and the ALU where the arithmetic is 
performed, and 


3) The result is moved into the accumulator. 


One input to the ALU is always provided from the accumulator, and the other input 
may be fed from the Product Register (PR) of the multiplier or the scaling shifter that 
is loaded from data memory. 
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Figure 3-7. Central Arithmetic Logic Unit (CALU) 


3.3.1 Scaling Shifter 
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The TMS320C25 scaling shifter has a 16-bit input connected to the data bus and a 
32-bit output connected to the ALU (see Figure 3-7). The scaling shifter produces 
a left shift of O to 16 bits on the input data, as programmed in the instruction. The 
LSBs of the output are filled with zeros, and the MSBs may be either filled with zeros 
or sign-extended, depending upon the status programmed into the SXM (sign-ex- 
tension mode) bit of status register STO. 


The TMS320C25 also contains several other shifters, which allow it to perform 
numerical scaling, bit extraction, extended arithmetic, and overflow prevention. These 
shifters are connected to the output of the multiplier and the accumulator. 
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3.3.2 


ALU and Accumulator 


The TMS320C25 32-bit ALU and accumulator implement a wide range of arithmetic 
and logical functions, the majority of which execute in a single clock cycle. Once 
an operation is performed in the ALU, the result is transferred to the accumulator 
where additional operations such as shifting may occur. Data that is input to the 
ALU may be scaled by the scaling shifter. 


The 32-bit accumulator (see Figure 3-7) is split into two 16-bit segments for storage 
in data memory: ACCH (accumulator high) and ACCL (accumulator low). Shifters 
at the output of the accumulator provide a left-shift of 0 to 7 places. This shift is 
performed while the data is being transferred to the data bus for storage. The contents 
of the accumulator remain unchanged. When the ACCH data is shifted left, the LSBs 
are transferred from the ACCL, and the MSBs are lost. When ACCL is shifted left, 
the LSBs are zero-filled, and the MSBs are lost. 


The accumulator also has an associated carry bit that is set or reset depending on 
various operations within the TMS320C25. The carry bit allows more efficient 
computation of extended-precision products and additions or subtractions. It is 
affected by most arithmetic instructions as well as the shift and rotate instructions. 
It is not affected by loading the accumulator, logical operations, or other such 
nonarithmetic or control instructions. It is also not affected by the multiply (MPY, 
MPYK, and MPYU) instructions, but is affected by the accumulation process in the 
MAC and MACD instructions. Examples of carry bit operation are shown in Figure 
3-8. 


C MSB LSB C MSB LSB 


XoPYP FF GOTO Xx 0000 0000 ACC 
Pi ea oe ~ 290) 1 
10000 0000 O FFFF FFFF 

Re eer es PoP er Ae X 8000 0000 ACC 
+S (OVM=0) - 4 (OVM=0) 
0 8000 0000 1 7FRFF FRFFF 

1 0000 0000 acc O FFFF FFFF ACC 


+ Q (ADDC - Q (SUBB 
0 0000 000 1 INSTRUCTION) 1 FFFF FF F E INSTRUCTION) 


Figure 3-8. Examples of Carry Bit Operation 


The value added to or subtracted from the accumulator, shown in the examples of 
Figure 3-8, may come from either the input scaling shifter or the shifter at the output 
of the P register. The carry bit is set if the result of an addition or accumulation process 
generates a carry, or reset to zero if the result of a subtraction generates a borrow. 
Otherwise, it is reset after an addition or set after a subtraction. 


The ADDC (add to accumulator with carry) and SUBB (subtract from accumulator 
with borrow) instructions use the previous value of carry in their addition/subtraction 
operation (see these instructions in Section 4 for more detailed information). 


The one exception to operation of the carry bit, as shown in Figure 3-8, is in the use 
of the ADDH (add to high accumulator) and SUBH (subtract from high accumulator) 
instructions. The ADDH instruction can only set the carry bit if a carry is generated, 
and the SUBH instruction can only reset the carry bit if a borrow is generated; 
otherwise, neither instruction can affect it. 
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Two branch instructions, BC and BNC, have been provided for branching on the 
status of the carry bit. The SC, RC, and LST1 instructions can also be used to load 
the carry bit. The carry bit is set to one on a hardware reset. 


The SFL and SFR (in-place one-bit shift to the left or right) and ROL and ROR (rotate 
to the left or right) instructions implement shifting or rotating of the contents of the 
accumulator through the carry bit. The SXM bit affects the definition of the SFR (shift 
accumulator right) instruction. When SXM = 1, SFR performs an arithmetic right 
shift, maintaining the sign of the accumulator data. When SXM = O, SFR performs 
a logical shift, shifting out the LSB and shifting in a zero for the MSB. The SFL (shift 
accumulator left) instruction is not affected by the SXM bit and behaves the same 
in both cases, shifting out the MSB and shifting in a zero. Repeat (RPT or RPTK) 
instructions may be used with the shift and rotate instructions for multiple shift 
counts. 


The TMS320C25 supports floating-point operations for applications requiring a large 
dynamic range. The NORM (normalization) instruction is used to normalize fixed- 
point numbers contained in the accumulator by performing left shifts. The LACT 
(load accumulator with shift specified by the T register) instruction denormalizes a 
floating-point number by arithmetically left-shifting the mantissa through the input 
scaling shifter. The shift count, in this case, is the value of the exponent specified 
by the four low-order bits of the T register (TR). ADDT and SUBT (add to/subtract 
from accumulator with shift specified by T register) instructions have also been 
provided to allow additional arithmetic operations. Floating-point numbers with 
16-bit mantissas and 4-bit exponents can thus be manipulated. 


The accumulator overflow saturation mode may be programmed through the SOVM 
and ROVM (set/reset overflow mode) instructions. When the accumulator is in the 
overflow saturation mode and an overflow occurs, the overflow flag is set and the 
accumulator is loaded with the most positive or negative number depending upon 
the direction of overflow. 


The TMS320C25 also has the capacity of executing branch instructions that depend 
on the status of the ALU and accumulator. These instructions include the BC (branch 
on carry), BV (branch on overflow), and BZ (branch on accumulator equal to zero) 
instructions. (Refer to Section 4 for a complete list of TMS320C25 instructions.) In 
addition, the BACC (branch to address in accumulator) instruction provides the 
ability to branch to an address specified by the accumulator. 


3.3.3 Multiplier, T and P Registers 


The TMS320C25 utilizes a 16 x 16-bit hardware multiplier, which is capable of 
computing a 32-bit product in a single machine cycle. As shown in Figure 3-7, the 
following two registers are associated with the multiplier: 


@ A 16-bit Temporary Register (TR) that holds one of the operands for the 
multiplier, and 


@ A 32-bit Product Register (PR) that holds the product. 


Normally, an LT (load T register) instruction loads the TR to provide one operand 
(from the data bus), and the MPY (multiply) instruction provides the second operand 
(also from the data bus). Alternatively, a multiplication can be performed with an 
immediate operand using the MPYK instruction. In either case, a product can be 
obtained every two cycles. 


Two multiply/accumulate instructions (MAC and MACD) fully utilize the computa- 
tional bandwidth of the multiplier, allowing both operands to be processed simul- 
taneously. For MAC and MACD, two operands are transferred to the multiplier each 
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cycle via the program and data buses. This provides for  single-cycle 
multiply/accumulates when used with repeat (RPT or RPTK) instructions. The MAC 
and MACD instructions can be used with operands in either internal or external 
memory. The SQRA (square/add) and SORS (square/subtract) instructions pass the 
same value to both inputs of the multiplier for squaring a data memory value. 


All multiply instructions, except the MPYU (multiply unsigned) instruction, perform 
a signed multiply operation in the multiplier. That is, the two numbers being multi- 
plied are treated as two’s-complement numbers, and the result is a 32-bit two’s- 
complement number. The MPYU instruction performs an unsigned multiplication, 
which greatly facilitates multiple-precision arithmetic operations. This allows oper- 
ands of greater than 16 bits to be broken down into 16-bit words and processed 
separately to generate products of greater than 32 bits. 


After the multiplication of two 16-bit numbers, the 32-bit product is loaded into the 
32-bit Product Register (PR). The product from the PR may be transferred to the 
ALU directly or optionally shifted before it is transferred to the ALU. 


Four product shift modes (PM) are available. The PM field of status register ST1 
specifies the PM shift mode, as shown in Table 3-3. 


Table 3-3. PM Shift Modes 


J IFPMis: | RESULT 


No shift ° 
Left shift of 1 bit 


Left shift of 4 bits 
Right shift of 6 bits 


Left shifts specified by the PM value are useful for implementing fractional arithmetic 
or justifying fractional products. For example, the product of either two normalized, 
16-bit, two’s-complement numbers or two Q15 numbers contains two sign bits, one 
of which is redundant (see Section 5.6.6 for an explanation of Q15 representation). 
The single-bit left shift allows this extra sign bit to be shifted off of the product when 
it is passed to the accumulator. This results in the accumulator contents being 
formatted in the same manner as the multiplicands. Similarly, the product of either 
a normalized, 16-bit, two’s-complement or Q15 number and a 13-bit, two’s- 
complement constant contains five sign bits, four of which are redundant. This is 
the case, for example, when using the MPYK instruction. Here the four-bit shift 
properly aligns the result as it is transferred to the accumulator. 


Use of the right-shift PM value allows the execution of up to 128 consecutive 
multiply/accumulate operations without the threat of an arithmetic overflow, thereby 
avoiding the overhead of overflow management. The shifter can be disabled to cause 
no shift in the product when working with integer or 32-bit precision operations. 
This allows compatibility with TMS32010 code to be maintained. Note that the PM 
right shift is always sign-extended regardless of the state of SXM. 


The four least significant bits of the T register (TR) also define a variable shift through 
the scaling shifter for the LACT/ADDT/SUBT (load/add-to/subtract-from accu- 
mulator with shift specified by the TR) instructions. These instructions are useful in 
floating-point arithmetic where a number needs to be denormalized, i.e., floating- 
point to fixed-point conversion. The BITT (bit test) instruction allows testing of a 
single bit of a word in data memory based on the value contained in the four LSBs 
of the TR. 
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3.4 System Control 


System control on the TMS320C25 is provided by the program counter and related 
hardware, the external reset signal, the status registers, the on-chip timer, and the 
repeat counter. The following sections describe the function of each of these 
components in system control. 


3.4.1 Program Counter and Related Hardware 


The description of the TMS320C25 Program Counter (PC) and its related hardware 
contained in this section provides information useful in understanding the sequence 
of external bus operations that occurs during instruction execution. It should be 
noted, however, that in virtually all cases, operation of this hardware and its effects 
on operation of the internal pipeline are transparent to the user and are included in 
the instruction cycle timings provided in Appendix E. 


The PC and related hardware (see Figure 3-9) direct program execution on the 
TMS320C25. Included in the related hardware are the eight-level PC stack, the 
Prefetch Counter (PFC), the 16-bit MicroCall Stack (MCS) register, the Instruction 
Register (IR), and the Queue Instruction Register (QIR). The operation of these 
components and their function in instruction pipelining is now described in detail. 


TO PROGRAM 


ADDRESS BUS 


(8 _x_ 16) 


Figure 3-9. Program Counter and Related Hardware 


In order to speed instruction execution, the TMS320C25 utilizes a three-level internal 
pipeline, which divides an instruction cycle into three operations: prefetch, decode, 
and execution. The PFC contains the address of the next instruction to be prefetched. 
Once an instruction is prefetched, the instruction is loaded into the IR, unless the IR 
still contains an instruction currently executing, in which case the prefetched 
instruction is stored in the QIR. The PFC is then incremented, and after the current 
instruction has completed execution, the instruction in the QIR is loaded into the IR 
to be executed. 
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The PC contains the address of the next instruction to be executed, and is not used 
directly in instruction fetch operations, but merely serves as a reference pointer to the 
Current position within the program. The PC is incremented as each instruction is 
executed. When interrupts or subroutine call instructions occur, the contents of the 
PC are pushed onto the stack to preserve return linkage to the previous program 
context. 


In the operation of the pipeline, the prefetch, decode, and execute operations are 
independent, which allows instruction executions to overlap. Thus, during any given 
cycle, three different instructions can be active, each at a different stage of 
completion, resulting in the three-instruction pipeline. Figure 3-10 shows the 
operation of the three-level pipeline for single-word, single-cycle instructions 
executing from either internal program ROM or external memory with no wait states. 


CLKOUT1 | | | | | | | 
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Figure 3-10. Three-Level Pipeline Operation 


Pipelining is reduced to two levels when execution is from internal program RAM 
due to the fact that an instruction in internal RAM can be fetched and decoded in 
the same cycle. Thus, separate prefetch and decode operations are not required, as 
shown in Figure 3-11. 
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Figure 3-11. Two-Level Pipeline Operation 


Note that the difference in pipeline levels does not necessarily affect instruction 
execution speed, but merely changes the fetch/decode sequence. Most instructions 
execute in the same number of cycles regardless of whether they are executed from 
internal RAM, ROM, or external program memory. Also note that the effects of 
pipelining are included in the instruction cycle timings listed in Appendix E. 


When branches, subroutine calls, or interrupts occur, the pipeline flow shown in 
Figure 3-12 and Figure 3-13 is disrupted because the pipeline prefetches sequen- 
tially, and cannot in general detect that a transfer of control will occur until an 
instruction reaches execution. This is especially true with conditional branches. 
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During branch or call instructions, both the PC and PFC are loaded with the desti- 
nation address, and the pipeline must be refilled. This causes these instructions to 
require at least three cycles to execute when the destination address is located 
externally or in internal program ROM. When the destination address is located in 
internal program RAM, branch instructions generally execute in two cycles, due to 
the two-level pipeline for internal RAM. In either case, some instructions that have 
been prefetched may be discarded as contro! passes to the branch destination 
address. Operation of the pipeline during interrupts is similar and is described in 
Section 3.6.2. 


Operation of the pipeline during execution of a conditional branch instruction such 
as a BANZ (branch on auxiliary register not zero), located in external program 
memory with no wait states, is shown in Figure 3-12. The diagram shows the 
sequence that occurs when the branch is taken, and the destination address is also 
in external memory. When the branch is not taken, instruction execution continues 
sequentially, and the branch instruction requires only two cycles to execute. Oper- 
ation of unconditional branches is identical to that of conditional branches with the 
exception that in conditional branches, the N+2 instruction is not fetched, although 
the address bus is still driven with N+2. 


CLKOUT1 | | | | | | | | | | | | | 


A15-A0 
prefetch : 
decode - 


execute | 
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Figure 3-12. Pipeline Operation During BANZ Instruction 


There is one additional condition under which the pipeline becomes disrupted. This 
is when execution of single-cycle instructions changes from internal RAM to external 
program memory or internal ROM. This occurs in only the following two cases: 


1) When execution of single-cycle instructions wraps around from >FFFF in block 
BO (when configured as program memory) to location >0000. 


2) When execution of single-cycle instructions is from block BO (configured as 
program memory) and a CNFD instruction is executed, converting block BO to 
data memory. 


Under these conditions, one dummy execute cycle occurs as the pipeline is refilled. 
This situation is depicted in Figure 3-13. Note that this condition occurs only under 
the above circumstances, and its effects are not included in the instruction cycle 
timings given in Appendix E. 
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Figure 3-13. Pipeline Operation When Crossing Program Boundaries 


3.4.2 Reset 


The contents of the accumulator may be loaded into the PC and PFC in order to 
implement “computed go to” operations. This can be accomplished using the BACC 
(branch to address in accumulator) or CALA (call subroutine indirect) instructions. 


The PC stack is accessible through the use of the PUSH and POP instructions. 
Whenever the contents of the PC are pushed onto the top of the stack, the previous 
contents of each level are pushed down, and the eighth location of the stack is lost. 
Therefore, data will be lost if more than eight successive pushes occur before a pop. 
The reverse happens on pop operations. Any pop after seven sequential pops yields 
the value at the eighth stack level. All eight stack levels then contain the same value. 
Two additional instructions, PSHD and POPD, push a data memory value onto the 
stack or pop a value from the stack to data memory. These instructions allow a stack 
to be built in data memory for the nesting of subroutines/interrupts beyond eight 
levels. 


The 16-bit MicroCall Stack (MCS) register is used expressly for temporary storage 
of the PFC contents during execution of the TBLR/TBLW, MAC/MACD, and 
BLKD/BLKP instructions. In these instructions, two operand addresses are required: 
one provided through either direct or indirect addressing, and the other loaded into 
the PFC. When execution of the instruction is completed, the contents of the MCS 
are transferred back to the PFC. 


Reset (RS) is a non-maskable external interrupt that can be used at any time to put 
the TMS320C25 into a known state. Reset is typically applied after powerup when 
the machine is in a random state. 


Driving the RS signal low causes the TMS320C25 to terminate execution and forces 
the program counter to zero. RS affects various registers and status bits. At powerup, 
the state of the processor is undefined. For correct system operation after powerup, 
a reset signal must be asserted low for at least three clock cycles to guarantee a reset 
of the device. Processor execution begins at location 0, which normally contains a 
B (branch) statement to direct program execution to the system initialization routine 
(see Section 5.1 for an initialization routine example). 


Upon receiving an RS signal, the following actions take place: 
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1) A logic 0 is loaded into the CNF (configuration control) bit in status register 
ST1, causing all RAM to be configured as data memory. 


2) The Program Counter (PC) is set to 0, and the address bus A15-A0 is driven 
with all zeroes while RS is low. 


3) The data bus D15-D0 is placed in the high-impedance state. 


4) All memory and |/O space control signals (PS, DS, IS, R/W, STRB, and BR) are 
de-asserted by setting them to high levels while RS is low. 


5) All interrupts are disabled by setting the INTM (interrupt mode) bit to a high 
level. (Note that RS is non-maskable). The interrupt flag register (IFR) is reset 
to all zeroes. 


6) Status bits: 
OV: + 7? AF: 1 0 Pa tio Ae: 0. Fon eC 
1 7 FSM (Remaining status bits are unchanged). 


7) The global memory allocation register (GREG) is cleared to make all memory 
local. 


8) The RPTC (repeat counter) is cleared. 


9) The DX (data transmit) pin is placed in the high-impedance state. Any 
transmit/receive operations on the serial port are terminated, and the TXM 
(transmit mode) bit is reset to a low level. This configures the FSX framing pulse 
to be an input. A transmit/receive operation may be started by framing pulses 
only after the removal of RS. 


10) The timer (TIM) and period (PRD) registers are both set to >FFFF and TIM 
does not begin decrementing until RS is de-asserted. 


11) The IACK (interrupt acknowledge) signal is generated in the same manner as a 
maskable interrupt. . 


Execution starts from location 0 of program memory when the RS signal is taken high. 
Note that if RS is asserted while in the hold mode, normal reset operation occurs 
internally, but all buses and control lines remain in the high-impedance state. Upon 
release of HOLD and RS, execution starts from location zero. 


Note that the ARB, ARP, DP, IMR, OVM, and TC bits are not initialized by reset. 


3.4.3 Status Registers 
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Two status registers, STO and ST1, contain the status of various conditions and 
modes. The SST and SST1 instructions provide for storing the status registers into 
data memory. The LST and LST1 instructions load the status registers from data 
memory. In this manner, the current status of the device may be saved on interrupts 
and subroutine Calls. 


Figure 3-14 shows the organization of both status registers, indicating all status bits 
contained in each. Note that the DP, ARP, and ARB registers are shown as separate 
registers in the processor block diagram of Figure 3-1. Because these registers do 
not have separate instructions for storing them into RAM, they are included in the 
status registers. 
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Figure 3-14. Status Register Organization 


The capability of storing the status registers into data memory and loading them from 
data memory allows the status of the machine to be saved and restored for interrupts 
and subroutines. All status bits are written to and read from using LST/LST1 and 
SST/SST1 instructions, respectively (with the exception of INTM, which cannot be 
loaded via an LST instruction). However, some additional instructions or functions 
may affect those bits, as indicated in Table 3-4. 


As shown in Figure 3-14, several bits in the status registers are reserved and are read 
as logic ‘1’s by the LST and LST1 instructions. 


Table 3-4. Status Register Field Definitions 


FUNCTION 


Auxiliary Register Pointer Buffer. Whenever the ARP is loaded, the old ARP value is copied to the ARB 
except during an LST instruction. When the ARB is loaded via an LST1 instruction, the same value is also 
copied to the ARP. 


Auxiliary Register Pointer. This three-bit field selects the AR to be used in indirect addressing. When ARP 
is loaded, the old ARP value is copied to the ARB register. ARP may be modified by memory-reference 
instructions when using indirect addressing, and by the LARP, MAR, and LST instructions. ARP is also 
loaded with the same value as ARB when an LST1 instruction is executed. 


Carry bit. This bit is set to ‘1’ if the result of an addition generates a carry, or reset to ‘0’ if the result of a 
subtraction generates a borrow. Otherwise, it is reset after an addition or set after a subtraction, except if 
the instruction is an ADDH or a SUBH. ADDH can only set and SUBH only reset the carry bit, but cannot 
affect it otherwise. The shift and rotate instructions also affect this bit, as well as the SC, RC, and LST1 
instructions. Two branch instructions, BC and BNC, have been provided to branch on the status of C. C 
is set to ‘1’ on a reset. The carry bit is useful in implementing multiple-precision arithmetic and in overflow 
management. 


On-Chip RAM Configuration Control bit. If set to ‘0’, block BO is configured as data memory; otherwise, 
block BO is configured as program memory. The CNF may be modified by the CNFD, CNFP, and LST1 
instructions. RS resets the CNF to ‘0’. 


Data Memory Page Pointer. The 9-bit DP register is concatenated with the 7 LSBs of an instruction word 
to form a direct memory address of 16 bits. DP may be modified by the LST, LDP, and LDPK instructions. 


Format bit. A ‘0’ configures the serial port registers as 16-bit registers. A ‘1’ configures the port registers to 
receive and transmit eight-bit bytes. FO may be modified by the FORT and LST1 instructions. FO is reset 
to ‘0’. 
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Table 3-4. Status Register Field Definitions (Concluded) 


FUNCTION 


Frame Synchronization Mode bit. This bit indicates whether the serial port will operate with or without frame 
sync pulses. When FSM = 1, the serial port operation will be initiated following a frame sync pulse on the 
FSX/FSR inputs. When FSM = 0, the FSX/FSR inputs are ignored and the serial port operates continuously 
with no frame sync pulses required. The bit is set to one by a reset. 


Hold Mode bit. When HM = 1, the TMS320C25 halts internal execution when acknowledging an active 
HOLD. When HM = 0, the processor may continue execution out of internal program memory but puts its 
external interface in a high-impedance state. This bit is set to one by a reset. 


Interrupt Mode. A ‘0’ enables all unmasked interrupts. A '1’ disables all maskable interrupts. INTM is set and 
reset by the DINT and EINT instructions. RS and IACK also set INTM. INTM has no effect on the unmaskable 
RS interrupt. Note that INTM is unaffected by the LST instruction. 


Overflow Flag. As a latched overflow signal, OV is set to ‘1’ when overflow occurs in the ALU. Once an 
overflow occurs, the OV remains set until a reset, BV, BNV, or LST instruction clears the OV. 


Overflow Mode. A ‘0’ causes overflowed results to overflow normally in the accumulator. A ‘1’ causes the 
accumulator to be set to either its most positive or negative value upon encountering an overflow. The SOVM 
and ROVM instructions set and reset this bit. LST may also be used to modify the OVM. 


Product Shift Mode. If these two bits are 00, the multiplier’s 32-bit product is loaded into the ALU with 
no shift. If PM = 01, the PR output is left-shifted one place and loaded into the ALU, with the LSBs 
zero-filled. If PM = 10, the PR output is left-shifted by four bits and loaded into the ALU, with the LSBs 
zero-filled. PM = 11 produces a right shift of six bits, sign-extended. Note that the PR contents remain 
unchanged. The shift takes place when transferring the contents of the PR to the ALU. PM is loaded with 
the SPM and LST1 instructions. The PM bits are cleared by RS. 


Sign-Extension Mode bit. A ‘1’ produces sign extension on data as it is passed into the accumulator through 
the scaling shifter. A ‘0’ suppresses sign extension. Note that SXM does not affect the definition of certain 
instructions. For example, the ADDS instruction suppresses sign extension regardless of SXM. This bit is 
set and reset by the SSXM and RSXM instructions and may also be loaded by LST1. SXM is set to ‘1’ by 
RS. 


Test/Control Flag bit. The TC bit is affected by the BIT, BITT, CMPR, LST1, and NORM instructions. The 
TC bit is set to a ‘1’ if: (1) a bit tested by BIT or BITT is a’1’, (2) a compare condition tested by CMPR exists 
between ARO and another AR pointed to by ARP, or (3) the exclusive-OR function of the two MSBs of the 
accumulator is true when tested by a NORM instruction. Two branch instructions, BBZ and BBNZ, provide 
branching on the status of the TC. 


Transmit Mode bit. A ‘1’ configures the serial port’s FSX pin to be an output. In this mode, a pulse is produced 
on FSX when DXR is loaded. Transmission then starts on the DX pin. A ‘0’ configures the FSX pin to be 
an input. TXM is set and reset by the STXM and RTXM instructions and may also be loaded by LST1. RS 
resets TXM to a ‘0’. 


XF pin status. A status bit indicating the state of the XF pin, a general-purpose output pin. XF is set and reset 
by the SXF and RXF instructions or may be loaded by LST1. XF is set to ‘1’ by RS. 


3.4.4 Timer Operation 


The TMS320C25 provides a memory-mapped timer (TIM) register and a period 
(PRD) register. The timer register is a down counter continuously clocked by 
CLKOUT1. Reset sets the timer and period registers (see Figure 3-15) to their 
maximum value (>FFFF). Upon release of reset, the timer begins decrementing. 
Following this, the TIM and PRD registers may be reloaded under program control. 
See Section 3.4.2 for reset information. 
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Figure 3-15. Timer Block Diagram 


The TIM register, data memory location 2, holds the current count of the timer. At 
every CLKOUT1 cycle, the TIM register is decremented by one. The PRD register, 
data memory location 3, holds the starting count for the timer. When the TIM 
register decrements to zero, a TINT (timer interrupt) is generated. In the next cycle, 
the contents of the PRD register are loaded into the TIM register. In this way, a 
TINT is generated every PRD + 1 cycles of CLKOUT1. By programming the PRD 
register from 1 to 65,535 (>FFFF), a TINT can be generated every 2 to 65,536 
cycles, respectively. A PRD register value of zero is not allowed. 


The timer and period registers can be read from or written to on any cycle. The count 
can be monitored by reading the TIM register. A new counter period can be written 
to the period register without disturbing the current timer count. The timer will then 
start the new period after the current count is complete. If both the PRD and TIM 
registers are loaded with a new period, the timer begins decrementing the new 
period without generating an interrupt. Thus, the programmer has complete control 
of the current and next periods of the timer. 


If the timer is not used, TINT should be masked or all maskable interrupts disabled 
by a DINT instruction. The PRD register can then be used as a general-purpose 
data memory location. If TINT is used, the PRD and TIM registers should be 
programmed before unmasking the TINT. 
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3.4.5 Repeat Counter 


The repeat counter (RPTC) is an 8-bit counter, which when loaded with a number 
N, causes the next single instruction to be executed N + 1 times. The RPTC can 
be loaded with a number from 0 to 255 using either the RPT (repeat) or RPTK 
(repeat immediate) instructions. This results in a maximum of 256 executions of a 
given instruction. RPTC is cleared by reset. 


The repeat feature can be used with instructions such as multiply/accumulates 
(MAC/MACD), block moves (BLKD/BLKP), I/O transfers (IN/OUT), and table 
read/writes (TBLR/TBLW). These instructions, which are normally multicycle, are 
pipelined when using the repeat feature, and effectively become single-cycle 
instructions. For example, the table read instruction may take three or more cycles 
to execute, but when repeated, a table location can be read every cycle. Note that 
not all instructions can be repeated (see Section 4.3 and Appendix E for more 
information). 


3.4.6 Powerdown Mode 


When operated in the powerdown mode, the TMS320C25 enters a dormant state 
and requires only a fraction of the power normally needed to supply the device. 
Powerdown mode is invoked either by executing an IDLE instruction or by driving 
the HOLD input low with the HM status bit set to one. 


While in powerdown mode, all of the internal contents of the processor are main- 
tained to allow operation to continue unaltered when powerdown mode is termi- 
nated. Powerdown mode is terminated upon receipt of an interrupt when an IDLE 
instruction is being executed or by removal of the HOLD input. (Refer to the IDLE 
instruction description in Section 4 and the hold function description in Section 
3.8.3 for further information.) Actual power supply current requirements in 
powerdown mode are specified in the TMS320C25 Data Sheet (Appendix A). 


3.5 External Memory and I/O Interface 


3-26 


Data, program, and |/O address spaces provide interfacing to memory and I/O, thus 
maximizing system throughput. The local memory interface consists of: 


@ A 16-bit parallel data bus (D15-D0O), 

@ A16-bit address bus (A15-A0), 

@ Data, program, and I/O space select (DS, PS, and IS) signals, and 
@ Various system control signals. 


The R/W (read/write) signal controls the direction of the transfer, and STRB 
(strobe) provides a timing signal to control the transfer. 


|/O design is simplified by having |/O treated the same way as memory. I/O devices 
are mapped into the |/O address space using the processor’s external address and 
data buses in the same manner as memory-mapped devices. 


Interfacing to memory and |/O devices of varying speeds is accomplished by using 
the READY line. When communicating with slower devices, the TMS320C25 
processor waits until the other device completes its function, signals the processor 
via the READY line, and continues execution. 
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3.5.1 Memory Combinations 


The exact sequence of operations performed as instructions execute depends on 
the areas in memory where the instructions and operands are located. There are 
six possible combinations of program and data memory since information can be 
located in either internal RAM, external memory, or internal ROM. The six possible 
combinations are: 


Program Internal RAM/Data Internal (PI/D1I) 
Program Internal RAM/Data External (PI/DE) 
Program External/Data Internal (PE/DI) 
Program External/Data External (PE/DE) 
Program Internal ROM/Data Internal (PR/DI) 
Program Internal ROM/Data External (PR/DE) 


Appendix E provides cycle timings for instructions both when repeated and when 
not repeated. The following is a summary of program execution, organized 
according to memory configuration. 


PI/DI or PR/DI When both program and data memory are on-chip, 
the processor runs at full speed with no wait states. 
Note that IN and OUT instructions have different 
cycle timings when program memory is internal; IN 
requires two cycles to execute while OUT requires 
only one. 


PE/DI This memory mode can run at full speed if external 
program memory is sufficiently fast since internal 
data operations can occur coincident with external 
program memory accesses. If external program 
memory is not fast enough, wait states may be 
generated using the READY input. 


PI/DE, PE/DE, or PR/DE Additional cycles are required to execute instructions 
that reference an external data memory space. At 
least two cycles are required to execute ‘read from 
external data memory’ instructions such as ADD, 
LAR, etc. Further additional cycles may be required 
due to wait states if external data memory is not fast 
enough to be accessed within a single cycle. Note, 
however, that the TMS320C25 has the capability of 
executing ‘write to external data memory’ 
instructions in a single cycle when program memory 
is internal (two cycles are required if program 
memory is also external). Additional cycles are also 
required in this case if external data memory is not 
sufficiently fast. 


Note that in all memory configurations where the same bus is used to communicate 
with external data, program, or |/O space, the number of cycles required to execute 
a particular instruction may further vary depending on whether the next instruction 
fetch is from internal or external program memory. Instruction execution and 
operation of the pipeline are discussed in detail in the following sections and in 
Section 3.4.1. 
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3.5.2 Internal Clock Timing Relationships 


The crystal or external clock source frequency is divided to produce an internal 
four-phase clock. The four phases are defined by CLKOUT1 and CLKOUT2, as 
shown in Figure 3-16. 


Phase # | Q3 | Q4 | Q1 | a2 | a3 | 24 | 


CLKOUT1 


CLKOUT2 


Q1 


Q2 


Figure 3-16. Four-Phase Clock 


Figure 3-16 shows the start of quarter-phase 3 (Q3) on the rising edge of 
CLKOUT1. To help facilitate the description of the TMS320C25’s operation, this 
nomenclature is used throughout this document. 


3.5.3 External Read Cycle 
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Each time an external read cycle is performed, a specific sequence of events occurs. 
This sequence of events is as follows: 


1) 


2) 


3) 


4) 


5) 


During clock quarter-phase 1, the processor begins driving the address bus 
and one of the memory space select signals. R/W is driven high to indicate 
an external memory read. 


At the beginning of quarter-phase 2, STRB is asserted to indicate that the 
address bus is valid. STRB, in conjunction with R/W, may be used to gate a 
read enable signal. 


After decoding the addressed memory area, the user’s memory interface must 
set up the appropriate READY signal during quarter-phase 2. READY is 
sampled by the processor at the beginning of quarter-phase 3. 


lf READY was high at the proper time, the data is clocked in at the end of 
quarter-phase 3. 


STRB is deasserted at the beginning of quarter-phase 4. The processor ends 
the memory access by deactivating the address bus and PS, DS, or IS. 


Note that the control signals PS, DS, IS, STRB, and R/W are only asserted when 
an external address location is being accessed. 
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Figure 3-17 shows the timing for several read operations. Two instructions are 
shown executing completely, an ADD and a SUB instruction. Note that a previous 
instruction is being executed while ADD and SUB are being fetched. Also note that 
while the SUB instruction is being executed, the next instruction, LAC, is being 
fetched even though execution of the LAC is not shown. 


The ADD instruction takes one cycle to execute because both the next instruction 
and the ADD’s data are internal. The SUB instruction that is fetched during ADD 
execution takes two cycles to execute because its data is external. The LAC 
instruction is fetched externally, but no wait state is needed since fast program 
memory is being used. STRB going high (inactive) signals the end of the read cycle. 
Data is clocked into the processor at the beginning of clock quarter-phase 4 if the 
READY signal was active at the beginning of quarter-phase 3 and satisfied the 
required setup time. 


Note that one dummy execute cycle occurs in the sequence of instructions because 
program execution changes from PI to PE. This is discussed in detail in Section 
3.4.1. 
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Figure 3-17. Read Cycle Functional Timing 
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3.5.4 External Write Cycle 


The sequence of events that occurs each time an external write cycle is performed, 
is as follows: 


1) During clock quarter-phase 1, the TMS320C25 begins driving the address 
bus and one of the memory space select signals. R/W is driven low to indicate 
an external memory write. 


2) At the beginning of quarter-phase 2, STRB is asserted to indicate that the 
address bus Is valid. STRB, in conjunction with R/W, may be used to gate a 
write enable signal. 


3) After decoding the addressed memory area, the user’s memory interface must 
provide the appropriate logic level to the READY signal input during quar- 
ter-phase 2. READY is sampled by the processor at the beginning of quar- 
ter-phase 3. 


4) The data bus begins to be driven at the start of quarter-phase 2. 


5) STRB is then deasserted at the beginning of quarter-phase 4. The processor 
ends the memory access by deactivating the address bus and PS, DS, or IS. 


The number of cycles in a memory or |/O access is determined by the state of the 
READY input. At the start of quarter-phase 3, the TMS320C25 samples the READY 
input. If READY is high, the memory access ends at the next falling edge of 
CLKOUT1. If READY is low, the memory cycle is extended by one machine cycle, 
and all other signals remain valid. At the beginning of the next quarter-phase 3, 
this sequence is repeated. Note that for on-chip program and data memory 
accesses, the READY input is ignored. 


Figure 3-18 illustrates the functional timing for write operations and wait states. 
The timing for three instructions, SACL, SAR, and SACH, is shown. The SACL 
instruction stores data in external data memory, and the next instruction fetched 
is in internal program memory. Therefore, the SACL instruction’s memory references 
are PI/DE. SACL only takes one cycle to complete, because the instruction writes 
to the zero wait-state external data memory. The SAR instruction references a PI/DI 
memory configuration. This instruction only takes one cycle to execute, because 
the data and program are internal. The SACH instruction uses slow external data 
memory (one wait state) and fast external program memory. SACH takes three 
cycles: one for the write to external data memory, one for a wait state since the 
external data is slow, and one for the external program fetch. External logic holds 
the READY line inactive during quarter-phase 2 to indicate a wait state. For write 
operations, STRB going high can be used to clock data into the external memory. 


One dummy execute cycle also occurs in this sequence of instructions, because 
program execution changes from PI to PE (see Section 3.4.1). 
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Figure 3-18. Functional Timing of Write Cycles and Wait States 


3.6 Interrupts 


The TMS320C25 has three external maskable user interrupts (INT2-INTO), available 
for external devices that interrupt the processor. Internal interrupts are generated 
by the serial port (RINT and XINT), by the timer (TINT), and by the software 
interrupt (TRAP) instruction. Interrupts are prioritized with reset having the highest 
priority and the serial port transmit interrupt having the lowest priority. 


3.6.1 Interrupt Operation 


This subsection details interrupt organization and management. Vector locations 
and priorities for all internal and external interrupts are shown in Table 3-5. The 
TRAP instruction, used for software interrupts, is not prioritized but is included here 
since it has its own vector location. Each interrupt address has been spaced apart 
by two locations so that branch instructions can be accommodated in those 
locations. 
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Table 3-5. Interrupt Locations and Priorities 


INTERRUPT MEMORY 
= LOCATION PRIORITY FUNCTION 
Z 


1 (highest) External reset signal 
External user interrupt #0 
External user interrupt #1 
External user interrupt #2 
Reserved locations 
Internal timer interrupt 
Serial port receive interrupt 
Serial port transmit interrupt 
TRAP instruction address 


7 (lowest) 
N/A 


When an interrupt occurs, it is stored in the 6-bit Interrupt Flag Register (IFR). This 
register is set by the external user interrupts INT(2-0) and the internal interrupts 
RINT, XINT, and TINT. Each interrupt is stored until it is recognized and then 
cleared by the IACK (interrupt acknowledge) signal or the RS (reset) signal. The 
RS signal is not stored in the IFR. No instructions are provided for reading from 
or writing to the IFR. 


The TMS320C25 has a memory-mapped Interrupt Mask Register (IMR) for 
masking external and internal interrupts. The layout of the register is shown in 
Figure 3-19. A ‘1’ in bit positions 5 through O of the IMR enables the corre- 
sponding interrupt, provided that INTM = 0. The IMR is accessible with both read 
and write operations but cannot be read using BLKD. When the IMR ts read, the 
unused bits (15 through 6) will be read as ‘1’s. The lower six bits are used to write 
to or read from the IMR. Note that RS is not included in the IMR, and therefore 
the IMR has no effect on reset. 


15 14 13 > oS 10 9 8 7 6 5 4 7 2 1 0 
meoetiis paint] rine] int [NTOINT INTO 


Figure 3-19. Interrupt Mask Register (IMR) 


The INTM (interrupt mode) bit, which is bit 9 of status register STO, enables or 
disables all maskable interrupts. A ‘0’ in INTM enables all the unmasked interrupts, 
and a ‘1’ disables these interrupts. The INTM is set to a ‘1’ by the IACK (interrupt 
acknowledge) signal, the DINT instruction, or a reset. This bit is reset to a ‘0’ by 
the EINT instruction. Note that the INTM does not actually modify the IMR or IFR. 


The TMS320C25 has a built-in mechanism for protecting multicycle instructions. 
If an interrupt occurs during a multicycle instruction, the interrupt is not processed 
until the instruction is completed. This also includes instructions that become 
multicycle due to the READY signal. 


In addition, the device also does not allow interrupts to be processed when an 
instruction is being repeated via the RPT or RPTK instructions. The interrupt is 
stored in the IFR until the repeat counter (RPTC) decrements to zero, and then the 
interrupt is processed. Note that even if the interrupt is de-asserted while the 
TMS320C25 is processing the RPT or RPTK, the interrupt will still be latched by 
IFR and be pending until RPTC decrements to zero. 
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If both the HOLD line and an interrupt go active during a multicycle instruction or 
a repeat loop, the HOLD takes control of the processor at the end of the instruction 
or loop. When HOLD is released, the interrupt is acknowledged. 


Interrupts cannot be processed between EINT and the next instruction in a program 
sequence. For example, if an interrupt occurs during an EINT instruction execution, 
the device always completes EINT as well as the following instruction before the 
pending interrupt is processed. This insures that a RET can be executed before the 
next interrupt is processed, assuming that a RET instruction follows the EINT. The 
state of the machine, upon receiving an interrupt, may be saved and restored (see 
Section 5.3.1). 


3.6.2 External Interrupt Interface 


INT(2-0) may be asynchronous edges or levels. The functional logic organization 
for INT(2-0) is shown in Figure 3-20. As shown in the figure, the external interrupt 
INTO is connected to an edge-triggered flip-flop. The INTO signal is ORed with the 
interrupt edge flip-flop Q output and synchronized with internal quarter-phases 1 
and 2 to produce an interrupt signal. In this way, the device can handle both 
edge-triggered and level-triggered interrupts. 


If the INTM bit and flag register have been properly enabled, the interrupt signal 
is accepted by the processor. An IACK (interrupt acknowledge) signal is then 
generated. The IACK clears the appropriate interrupt edge flip-flop and disables 
the INTM latch. The logic is the same for INT1 and INT2. 
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Figure 3-20. Internal Interrupt Logic Diagram 


In a typical interrupt (INT2-INTO) operation, the interrupt is generated by a nega- 
tive-going edge and the IFR bit is set. Since INTM is disabled when the interrupt 
is acknowledged, the level may continue to be present on the INT input without 
generating further interrupts. If the level is removed before an EINT instruction is 
executed, no further interrupts are generated. If a low level continues to be present 
after the EINT, another interrupt is generated after the EINT/next instruction 
sequence. In addition, if the INT pin is pulsed between the previous IACK and EINT, 
another interrupt is generated after EINT/RET, because the corresponding IFR bit 
is again set. 


The timing diagram of Figure 3-21, shows an interrupt, interrupt acknowledge, and 
various other signals for the special case of single-cycle instructions. An interrupt 
generated during the current (N) fetch cycle still allows the fetch and execution 
of that instruction. The N+1 and N+2 instructions are also fetched, then discarded, 
and the address N+1 is pushed onto the top of the stack. The instruction is fetched 
again upon a return command from the interrupt routine. 


As shown in Figure 3-21, two dummy execute cycles occur on an interrupt. The 
IACK signal is asserted low during CLKOUT1 low when the device initiates a fetch 
from interrupt location |. Therefore, an external device can determine the interrupt 
that occurred by latching the address bus value present on A4-A1 with the rising 
edge of CLKOUT2 when IACK is low. 
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Notes: 1. Nis the program memory location for the current instruction. 
2 | is the interrupt vector location in program memory for the active 
interrupt. 
3. For simplicity, this example only shows the execution of single-cycle 
instructions fetched from external program memory, rather than 
multicycle instructions. 


Figure 3-21. Interrupt Timing Diagram 


3.7 Serial Port 


The on-chip serial port provides direct communication with serial devices such as 
codecs, serial A/D converters, and other serial systems. The interface signals are 
compatible with codecs and many other serial devices with a minimum of external 
hardware. The serial port may also be used for intercommunication between 
processors in multiprocessing applications. 


Serial port operation is controlled by the following registers and mode bits: 


Data Transmit Register (DXR) 

Transmit Shift Register (XSR) 

Data Receive Register (DRR) 

Receive Shift Register (RSR) 

Format bit (FO) 

Transmit Mode bit (TXM) 

Frame Synchronization Mode bit (FSM) 


The serial port uses two memory-mapped registers: the DXR register that holds the 
data to be transmitted by the serial port, and the DRR register that holds the 
received data (see Figure 3-22). Any instruction accessing data memory can be 
used to read from or write to these registers; however, the BLKD (block move from 
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data memory to data memory) instruction cannot be used to read these registers. 
The DXR and DRR registers are mapped into locations O and 1 in the data address 
space. The XSR and RSR registers are not directly accessible through software. 


ADDRESS 
MSB LSB 
>0001 DXR 


Figure 3-22. The DRR and DXR Registers 


The transmit and receive sections of the serial port are implemented separately to 
allow independent transmit and receive operations, as shown in Figure 3-23. 
Externally, the serial port interface is implemented using the following six pins on 
the TMS320C25 device: 


Transmitted serial data (DX) 

Transmit clock (CLKX) 

Transmit framing synchronization signal (FSX) 
Received serial data (RX) 

Receive clock (CLKR) 

Receive framing synchronization signal (FSR) 


The data on the DX and DR pins is clocked out of or into the XSR or RSR by the 
CLKX or CLKR signal, respectively. CLKX and CLKR are only required to be present 
during actual serial port transfers, and may be stopped when no data is being 
transferred. Data bits can be transferred in either 8-bit bytes or 16-bit words. Data 
is clocked out of XSR on the rising edges of CLKX, while data is clocked into RSR 
on the falling edges of CLKR. The MSB of the data is transferred first. 


The XSR and RSR are connected to the DXR and DRR, respectively. For transmit 
Operations, the contents of DXR are transferred to XSR when a new transmission 
begins. For a receive operation, the contents of RSR are transferred to DRR when 
all of the bits have been received. Thus, the serial port is double-buffered since 
data may be transferred to or from the DXR or DRR while another transmit or receive 
operation is being performed. 
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Figure 3-23. Serial Port Block Diagram 


Serial port transfers are generally initiated by a frame sync pulse. The exception to 
this is when the continuous mode of operation is used with FSM=0, as described 
in a subsequent paragraph. Frame sync pulses are input on FSX for transmit 
operations and on FSR for receive operations. 


Upon completion of a serial port transfer, an internal interrupt is generated. The 
RINT interrupt is generated for a receive operation, and XINT is generated for a 
transmit operation. RINT and XINT are generated on the rising edge of CLKR and 
CLKX, respectively, after the last bit is transferred. Note that if DRR is read before 
a RINT is received, it will contain the data from the previous operation. Similarly, 
if DXR is loaded more than once after an XINT is generated (in the continuous 
transmission mode), only the last value written will be loaded into XSR for the next 
transmit operation. 


When the TMS320C25 is reset, TXM is cleared to zero, and DX is placed in a 
high-impedance state. Any transmit or receive operation that is in progress when 
the reset occurs is terminated. 


If the serial port is not being used, the DRR and DXR registers can be used as 
general-purpose registers. In this case, the CLKR or FSR should be connected to 
a logic low to prevent a possible receive operation from being initiated. 


The FO (format) bit, located in status register ST1, is used to define whether data 
to be transmitted and received is an 8-bit byte or a 16-bit word. If FO = O, the 
data is formatted in 16-bit words. If FO = 1, the data is formatted in 8-bit bytes. 
In the 8-bit mode, only the lower eight least-significant bits are used for 
transmit/receive operations. The FO bit is loaded by the FORT (format serial port 
registers) instruction. On reset, FO is set to a ‘0’. 
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The TXM (transmit mode) bit, also located in status register ST1, is used to 
determine if the frame sync pulse for the transmit operation is generated internally 
or externally. If TXM=0, FSX is an input, but if TXM=1, FSX becomes an output 
and frame sync pulses are produced on FSX at the beginning of a serial port tran- 
smission. The TXM bit can be loaded by the LST1, STXM, or RTXM instructions. 


The FSM (frame synchronization mode) status register bit is used to select whether 
frame sync pulses are required for each serial port transfer. lf FSM=1, frame sync 
pulses are required; if FSM=0O, they are not required. FSM is set by the SFSM (set 
frame synchronization mode) instruction and cleared by the RFSM (reset frame 
synchronization mode) instruction. 


The timing of the serial port signals is compatible with the Tl/Intel 2910 series 
codecs. The timing is also compatible with the AMI S3506 series codecs if the 
frame synchronization signals are inverted. 


3.7.1 Burst-Mode Operation 
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FSX 
(TXM=1) 


DX 
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XINT 


LOADED 
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In burst-mode serial port operation, transfers are separated in time by periods of 
no serial port activity (the serial port does not operate continuously). For burst- 
mode operation, FSM must be set to one. Timing of the serial port in this mode 
of operation is shown in Figure 3-24 and Figure 3-25. 


DXR DXR 
LOADED RELOADED 


XSR XSR 
RELOADED 


Figure 3-24. Burst-Mode Serial Port Transmit Operation 
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Figure 3-25. Burst-Mode Serial Port Receive Operation 


When TXM=1 (in the transmit operation) and the serial port register DXR is loaded, 
a framing pulse is generated on the next rising edge of CLKX. XSR is loaded with 
the current contents of DXR while FSX is high and CLKX is low. Transmission 
begins when FSX goes low while CLKX is high or is going high. Figure 3-24 shows 
the timing for the byte mode (FO=1). XINT is generated on the rising edge of CLKX 
after all 8 or 16 bits have been transmitted and DX is placed in the high-impedance 
state. If DXR is reloaded before the next rising edge of CLKX after XINT, FSX will 
again be generated as shown, and XSR will be reloaded. 


The receive operation is very similar to the transmit operation. The contents of RSR 
are loaded into DRR while CLKR is low, just after reception of the last bit sent by 
the transmitting device (see Figure 3-25). RINT is generated on the next rising 
edge of CLKR, and DRR may be read at any time before the reception of the final 
bit of the next transmission. When operating in the byte mode, the eight most- 
significant bits of the DRR are the contents of the eight least-significant bits of the 
DRR prior to reception of the current byte, as shown in Figure 3-26. 
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Figure 3-26. Byte-Mode DRR Operation 
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3.7.2 Continuous-Mode Operation Using Frame Sync Pulses 
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The TMS320C25 provides two modes of operation that allow the use of a 
continuous stream of serial data. When FSM=1, frame sync pulses are required, 
but since DXR is double-buffered, continuous operation is achieved even if 
TXM=1. Writing to DXR during a serial port transmission does not abort the 
transmission in progress, but instead DXR stores that data until XSR can be 
reloaded. As long as DXR is reloaded before the CLKX rising edge on the final bit 
being transmitted, the FSX pulse will go high on the rising edge of CLKX during 
the transmission of the final bit and fall on the next rising edge when transmission 
of the word just loaded begins. If DXR is not reloaded within this period and FSM 
=1, the DX pin will be placed in a high-impedance state for at least one CLKX cycle 
until DXR is reloaded (as described in the previous section). Figure 3-27 and Figure 
3-28 show the timing diagrams for the continuous operation with frame sync 
pulses. 
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Figure 3-27. Serial Port Transmit Continuous Operation (FSM=1) 
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Figure 3-28. Serial Port Receive Continuous Operation (FSM=1) 


Continuous receive operation with FSM= 1 is identical to that of burst-mode 
operation with the exception that FSR is pulsed during reception of the final bit. 


3.7.3  Continuous-Mode Operation Without Frame Sync Pulses 


The continuous mode of operation allows transmission and reception of a contin- 
uous bit stream without requiring frame sync pulses every 8 or 16 bits. This mode 
is selected by setting FSM=0. 


Figure 3-29 and Figure 3-30 show operation of the serial port for both states of 
FSM to illustrate differences in operation for each case. FSM is initially set to one, 
and frame sync pulses are required to initiate serial transfers. During processing 
of the next serial port interrupt (XINT or RINT), FSM is reset to zero by means of 
an RFSM (reset FSM) instruction. RFSM can occur either before or after the write 
to DXR or read from DRR. From this point on, the FSX and FSR inputs are ignored, 
with transmission occurring every CLKX cycle and reception occurring every CLKR 
cycle as long as those clocks are present. 
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Figure 3-29. Serial Port Transmit Continuous Operation (FSM=0) 
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Figure 3-30. Serial Port Receive Continuous Operation (FSM=0) 


If FSX is configured as an output, it will remain low until FSM is set back to one 
and DXR is reloaded. If DXR is not reloaded with new data every XINT (every 8 
or 16 CLKX cycles depending on FO), the last value loaded will be transmitted on 
DX continuously. Note that this is different from the case with FSM=1 where DX 
is placed into a high-impedance state if DXR is not reloaded before transmission 
of the last bit of the current word in XSR. For example,if byte C is not loaded into 


DXR as indicated in Figure 3-29, bits B1-B8 will be retransmitted instead of bits 
C1 and C2 as shown. 
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For receive operations, DRR is loaded from RSR (and an RINT is generated) every 
8 or 16 CLKR cycles (depending on FQ), regardless of whether or not DRR has 
been read. An overrun of DRR is also possible with FSM=1 if DRR is not read 
before the next RINT. The only way to stop continuous transmission or reception 
once started, when FSM=0, is to either stop CLKX or CLKR or to perform an SFSM 
(set FSM) instruction. 


Continuous transmission without frame sync pulses is very useful in communicating 
directly to telephone system PCM highways. For AT&T T1 and CCITT G711/712 
lines, FSX and FSR pulses are generated only every 24 or 32 bytes. By counting 
the transmitted and received bytes in software after an initial FSX or FSR and 
performing SFSM and RFSM instructions as required, the TMS320C25 can easily 
be made to communicate in these formats. 


3.7.4 Initialization of Continuous-Mode Operation Without Frame Sync Pulses 
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FSM its normally initialized during an XINT or RINT service routine to enable or 
disable FSX and FSR, respectively, for the next serial port operation. However, in 
order to initialize the continuous-mode operation, it is permissible to reset FSM to 
zero before a serial port transmit or receive is initiated. As shown in Figure 3-31 
and Figure 3-32, RFSM may occur before a write to DXR, regardless of the state 
of TXM. If TXM=1, FSX is generated in a normal manner on the next rising edge 
of CLKX, but only once. If TXM=0, the TMS320C25 waits to transmit until FSX 
is pulsed, but from then on, the FSX input is ignored. Note that just as in the case 
of continuous-mode operation without sync pulses described in Section 3.7.3, the 
first data written to DXR (byte A) is output twice unless DXR is reloaded before 
the second transmission is started. It is important to consider this dummy cycle 
when using continuous-mode serial operation. 
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Figure 3-31. Continuous Transmit Operation Initialization 


3-43 


Device Operation 


CLKR 


FSR 


DR 
(FO=1) 


RINT 


RFSM DRR 
LOADED 
FROM RSR 


Figure 3-32. Continuous Receive Operation Initialization 


The receive timings are the same as those for the transmit operations with TXM=0. 
The TMS320C25 waits to receive data until FSR is pulsed, but thereafter the FSR 
input is ignored. No dummy cycle is associated with the receive operation due to 
the postbuffering nature of DRR as opposed to the prebuffering nature of DXR. 


3.8 Multiprocessing and Direct Memory Access (DMA) 


The flexibility of the TMS320C25 allows configurations to satisfy a wide range of 
system requirements. Some of the system configurations using the TMS320C25 
are as follows: 


@ A standalone system (single processor) 


@ A host/slave or parallel multiprocessing system with shared global data 
memory 


@ A host/peripheral coprocessor configuration using interface control signals. 


These system configurations are made possible by three specialized features of the 
TMS320C25. These three features are the synchronization function utilizing the 
SYNC input, the global memory interface, and the hold function implemented with 
the HOLD and HOLDA pins. The following sections describe these functions in 
detail. 
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3.8.1 Synchronization 


In a multiprocessor environment, the SYNC input can be used to greatly ease 
interface between processors. This input is used to cause each of the TMS320C25s 
in the system to synchronize their internal clocks, thereby allowing the processors 
to run in lock-step operation. 


Multiple TMS320C25s are synchronized by using common SYNC and external 
clock inputs. A negative transition on SYNC sets each processor to internal quar- 
ter-phase one (Q1). This transition must occur synchronously with the rising edge 
of CLKIN. The timing diagram for the SYNC input is shown in Figure 3-33. Note 
that there is a two CLKIN cycle delay following the cycle in which SYNC goes low, 
before the synchronized Q1 occurs. 


Phase # Q4 Q1 Q2 Q3 Q1 Q2 Q3 Q4 


CLKIN 


SYNC 


CLKOUT1 


CLKOUT2 


Figure 3-33. Synchronization Timing Diagram 


Normally, SYNC is applied while RS is active. If SYNC is asserted after a reset, the 
following can occur: 


1) The processor machine cycle is reset to Q1, provided that the timing 
requirements for SYNC are met. If SYNC is asserted at the beginning of Q1, 
Q3, or Q4, the current instruction is improperly executed. If SYNC is asserted 
at the beginning of Q2, the current instruction is executed properly. 


2) If SYNC does not meet the timing requirements, unpredictable processor 
operation occurs. A reset should then be executed to place the processor back 
in a Known state. 


3.8.2 Global Memory 


For multiprocessing applications, the TMS320C25 has the capability of allocating 
global data memory space and communicating with that space via the BR (bus 
request) and READY control signals. 


Global memory is memory shared by more than one processor; therefore, access 
to it must be arbitrated. When using global memory, the processor’s address space 
is divided into local and global sections. The local section is used by the processor 
to perform its individual function, and the global section is used to communicate 
with other processors. 
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A memory-mapped register (GREG) is provided that allows part of data memory 
to be specified as global external memory. GREG, which is memory-mapped at data 
memory address location 5, is an eight-bit register connected to the eight LSBs 
of the internal D bus. The upper eight bits of location 5 are nonexistent and read 
as ‘1's. 


The contents of GREG determine the size of the global memory space. The legal 
values of GREG and corresponding global memory spaces are shown in Table 3-6. 
Note that values other than those listed in the table lead to fragmented memory 
maps. 


Table 3-6. Global Data Memory Configurations 


LOCAL MEMORY GLOBAL MEMORY 
GREG VALUE RANGE # WORDS RANGE # WORDS 
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When a data memory address, either direct or indirect, corresponds to a global data 
memory address (as defined by GREG), BR is asserted low with DS to indicate that 
the processor wishes to make a global memory access. External logic then arbitrates 
for control of the global memory, asserting READY when the TMS320C25 has 
control. One wait-state timing is shown in Figure 3-34. Note that all signals not 
shown have the same timing as in the normal read or write case. 


Pesee 4° [ 71°, °2 | 8 1 4 ‘|eithsune® codweten 4 411 


CLKOUT1 


STRB 


A15-AO 


Figure 3-34. Global Memory Access Timing 
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3.8.3 The Hold Function 


The TMS320C25 supports Direct Memory Access (DMA) to its local (off-chip) 
program, data, and |/O spaces. Two signals, HOLD and HOLDA, are provided to 
allow another device to take control of the processor’s buses. Upon receiving a 
HOLD signal from an external device, the processor acknowledges by bringing 
HOLDA low. The processor then places its address and data buses as well as all 
control signals (PS, DS, IS, R/W, and STRB) in the high-impedance state. The serial 
port output pins, DX and FSX, are not affected by HOLD. 


The timing for the HOLD and HOLDA signals is shown in Figure 3-35. HOLD has 
the same setup time as READY and is sampled at the beginning of quarter-phase 
3. If the setup time is met, it takes three machine cycles before the buses and control 
signals go to the high-impedance state. Note that unlike the external interrupts 
INT(2-0), HOLD is not a latched input. The external device must keep HOLD low 
until it receives a HOLDA from the TMS320C25. 


The hold function has two distinct operating modes, which are selected by the 
HM (hold mode) status register bit. The HOLD signal is pulled low, as shown in 
the first part of Figure 3-35. When HM=1, the TMS320C25 halts program 
execution and enters the hold state directly. When HM=0, the processor enters 
the hold state directly, as shown in Figure 3-35, if program execution is from 
external memory or if external data memory is being accessed. If program execution 
is from internal memory, however, and if no external data memory accesses are 
required, the processor enters the hold state externally, but program execution 
continues internally. This allows more efficient system operation since a program 
may continue executing while an external DMA operation is being performed. 


Note that if the processor is in a hold state with HM=0O and an internally executing 
program requires an external access, or if the program branches to an external 
address, program execution ceases until HOLD is removed. Also, if a repeat 
instruction that requires the use of the external bus is executing with HM=0O and 
a hold occurs, the hold state is entered after the current bus cycle. If this situation 
occurs with HM=1, the hold state will not be entered until the repeat count is 
completed. HM is set and reset by the SHM (set hold mode) and RHM (reset hold 
mode) instructions, respectively. 


If the TMS320C25 is in the middle of a multicycle instruction, it will finish the 
instruction before entering the hold state. After the instruction is completed, the 
buses are placed in the high-impedance state. This also applies to instructions that 
become multicycle due to insertion of wait states. 


After HOLD is de-asserted, program execution resumes from the same point at 
which it was halted. HOLDA is removed synchronously with HOLD, as shown in 
Figure 3-35. If the setup time is met, two machine cycles are required before the 
buses and control signals become valid. 


All interrupts are disabled while HOLD is active with HM=1. If an interrupt is 
received during this period, the interrupt is latched and remains pending. HOLD 
itself does not affect any interrupt flags or registers. If HM=0O, interrupts function 
normally. 


HOLD is not treated as an interrupt. If the TMS320C25 was executing the IDLE 
instruction before entering the hold state, it resumes executing IDLE once it leaves 
the hold state. 
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Phase # 11, 2,8 5411, 2,2 4} .1, 2p a | 


CLKOUT1 


STRB 


fetch 


execute 


HOLDA 


Notes: 1. Nis the program memory location for the current instruction. 
2. This example only shows the execution of single-cycle instructions 
fetched from external program memory. 


Figure 3-35. Hold Timing Diagram 
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Device Operation 


Phase # f+ $2 73), | £yeh ee £1 Se. 3h bot eh al tree Bs 41-41-21 81-41 


CLKOUT1 
STRB 
HOLD 


A15-A0 


PS, DS. 
OR | 


R/W 
D15-D0 
fetch 
execute 


HOLDA 


Figure 3-35. Hold Timing Diagram (Concluded) 


3.9 General-Purpose I/O Pins 


The TMS320C25 has two general-purpose pins that are software-controlled. The 
BIO pin is a branch control input pin, and the XF pin is an external flag output pin. 


3.9.1 BIO Input 


When the BIO input pin is active (low), execution of the BIOZ instruction causes 
a branch to occur. 


The BIO pin is useful for monitoring peripheral device status. It is especially useful 
as an alternative to using an interrupt when it is necessary not to disturb time-cri- 
tical loops. 


Figure 3-36 shows the BIO timing diagram. BIO is sampled at the end of quar- 
ter-phase 4. Note that the timing diagram shown is for a sequence of single-cycle, 
single-word instructions without branches located in external memory. Because 
of variations in pipelining due to instructions prior to and following the BIOZ 
instruction, this timing may vary. Therefore, it is recommended that several cycles 
of setup be provided if BIO is to be recognized on a particular cycle. 
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Device Operation 


Phase# (1 4:21:3141112131411121314111213141 


CLKOUT1 


: (BRANCH: (NEXT _( 
(BIOZ) =: ADDRESS) < INSTRUCTION) N+3 OR BRANCH 
ee kere... eee Seem R 


Figure 3-36. BIO Timing Diagram 


3.9.2 External Flag Output 
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The XF (external flag) output pin is set to a high level by the SXF (set external flag) 
instruction and reset to a low level by the RXF (reset external flag) instruction. XF 
is set high by RS. 


The relationship between the time the SXF/RXF instruction is fetched before the 
XF pin is set or reset is shown in Figure 3-37. As with BIO, the timing shown for 
XF is for a sequence of single-cycle, single-word instructions located in external 
memory. Actual timing may vary with different instruction sequences. 


Device Operation 


Phase # See oO ey tees oe oe eo ee ve oe ee ee et oe 


A15-A0O 


: (SXF OR RXF) - 3 ; 
fetch .¢—__"* ___-»¢—__""" _»4_"““< _,», “te 4 


se ; ; | 

(SXF) ee ee ee 
XF Sane 3 7 | : \ : 

(RXF) 


N + 1 N +2 N+3 


Notes: 1. N is the program memory location for the current instruction. 
This example only shows the execution of single-cycle instructions 
fetched from external program memory. 


Figure 3-37. External Flag Timing Diagram 
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4. Assembly Language Instructions 


The TMS320C25 instruction set supports numeric-intensive signal processing 
operations as well as general-purpose applications, such as multiprocessing and 
high-speed _ control. TMS32010 source code is upward-compatible with 
TMS320C25 source code. TMS32020 object code is upward-compatible with 
TMS320C25 object code. 


This section describes the assembly language instructions for the TMS320C25 
microprocessor. Included in this section are the following major topics: 


% Memory Addressing Modes (Section 4.1 on page 4-2) 
Direct addressing 
Indirect addressing (using eight auxiliary registers) 
Immediate addressing 


® Instruction Set (Section 4.2 on page 4-8) 
Symbols and abbreviations used in the instructions 
Instruction set summary (listed according to function) 


& Individual Instruction Descriptions (Section 4.3 on page 4-13) 
Presented in alphabetical order and providing the following: 
- Assembler syntax 
- Operands 
- Execution 
- Encoding 
- Description 
- Words 
- Cycles 
- Repeatability 
- Example(s) 
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Assembly Language Instructions 


4.1 Memory Addressing Modes 


The TMS320C25 instruction set provides three memory addressing modes: 


e Direct addressing mode 
® Indirect addressing mode 
2 Immediate addressing mode 


Both direct and indirect addressing can be used to access data memory. Direct 
addressing concatenates seven bits of the instruction word with the nine bits of the 
data memory page pointer to form the 16-bit data memory address. Indirect 
addressing accesses data memory through the eight auxiliary registers. In immediate 
addressing, the data is based on a portion of the instruction word(s). The following 
sections describe each addressing mode and give the opcode formats and some 
examples for each mode. 


4.1.1 Direct Addressing Mode 
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In the direct memory addressing mode, the instruction word contains the lower seven 
bits of the data memory address (dma). This field is concatenated with the nine bits 
of the data memory page pointer (DP) register to form the full 16-bit data memory 
address. Thus, the DP register points to one of 512 possible 128-word data memory 
pages, and the 7-bit address in the instruction points to the specific location within 
that data memory page. The DP register is loaded through the LDP (load data memory 
page pointer), LDPK (load data memory page pointer immediate), or LST (load status 
register STO) instructions. Figure 4-1 illustrates how the 16-bit data address is 
formed. 


(OODO OOO DOOOOD OOOO OODOOOOOOEE — ar ee Wa Se BOP 8 WOO OOOO 
MMMM Me ee i i. a i, ee | ie | ee OF are 


RS Ie me! ee! Wee 4 eb ee Be) oD SOOO CC 
ntoeteretecetaretatetesetetstarersceteretatsretererets LD ratereteteteteteteteteteateetetetetereleetetettere’s 


7 LSBS FROM 
INSTRUCTION 
REGISTER (IR) 


16-BIT DATA ADDRESS 


Figure 4-1. Direct Addressing Block Diagram 


Direct addressing can be used with all instructions except CALL, the branch 
instructions, immediate operand instructions, and instructions with no operands. The 
direct addressing format is as follows: 


a Ss Fe ie Ra EP a eae ae a 0 


Ce ee dma 


Bits 15 through 8 contain the opcode. Bit 7 = O defines the addressing mode as 
direct, and bits 6 through O contain the data memory address (dma). 
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Example of Direct Addressing Format: 


ADD 9,5 Add to accumulator the contents of data memory location 9 left- 
shifted 5 bits. 


46 vigeonoseigediss QL om IBA TA toprneHioI4 3° 2 1 0 
Orson. Seas Oct neds ad aaa teteeecoO: 10 20 


The opcode of the ADD 9,5 instruction is >O5 and appears in bits 15 through 8. The 
notation >nn indicates nn is a hexadecimal number. The shift count of >5 appears 
in bits 11 through 8 of the opcode. The data memory address >09 appears in bits 
6 through 0. 


4.1.2 Indirect Addressing Mode 


The eight auxiliary registers (ARO-AR7) provide flexible and powerful indirect 
addressing. To select a specific auxiliary register, the Auxiliary Register Pointer (ARP) 
is loaded with a value from 0 through 7, designating ARO through AR7, respectively 
(see Figure 4-2). 


The contents of the auxiliary registers may be operated upon by the Auxiliary Register 
Arithmetic Unit (ARAU), which implements 16-bit unsigned arithmetic. The ARAU 
performs auxiliary register arithmetic operations in the same cycle as the execution 
of the instruction. (Note that the increment or decrement of the indicated AR is 
always executed after the use of that AR in the instruction.) 


AUXILIARY 
REGISTERS 


16-BIT DATA ADDRESS 


Figure 4-2. Indirect Addressing Block Diagram 


In indirect addressing, any location in the 64K data memory space can be accessed 
via the 16-bit addresses contained in the auxiliary registers. These may be loaded 
by the instructions LAR (load auxiliary register), LARK (load auxiliary register 
immediate), and LRLK (load auxiliary register long immediate). The auxiliary registers 
may be modified by ADRK (add to auxiliary register short immediate) or SBRK 
(subtract from auxiliary register short immediate). The auxiliary registers may also 
be modified by the MAR (modify auxiliary register) instruction or, equivalently, by 
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the indirect addressing field of any instruction supporting indirect addressing. 
AR(ARP) denotes the auxiliary register selected by ARP. 


The following symbols are used in indirect addressing: 


* 


Contents of AR(ARP) are used as the data memory address. 


* 


- Contents of AR(ARP) are used as the data memory address, then decre- 
mented after the access. 


+ Contents of AR(ARP) are used as the data memory address, then incre- 
mented after the access. 


*0- Contents of AR(ARP) are used as the data memory address, and the 
contents of ARO subtracted from it after the access. 


"O+ Contents of AR(ARP) are used as the data memory address, and the 
contents of ARO added to it after the access. 


*BRO- Contents of AR(ARP) are used as the data memory address, and the 
contents of ARO subtracted from it (with reverse carry propagation) after 
the access. 


*BRO+ Contents of AR(ARP) are used as the data memory address, and the 
contents of ARO added to it (with reverse carry propagation) after the access. 


There are two main types of indirect addressing with indexing: 


# Regular indirect addressing with increment or decrement, and 
& Indirect addressing with indexing based on the value of ARO. 


In either case, the contents of the auxiliary register pointed to by the ARP register 
are used as the address of the data memory operand. Then, the ARAU performs the 
specified mathematical operation on the indicated auxiliary register. Additionally, the 
ARP may be loaded with a new value. 


Indirect auxiliary register addressing allows for post-access adjustments of the 
auxiliary register pointed to by the ARP. The adjustment may be an increment or 
decrement by one or based upon the contents of ARO. 


Indirect addressing can be used with all instructions except immediate operand 
instructions and instructions with no operands. The indirect addressing format is 
as follows: 


15 14 13 S Sa 10 9 8 Fj 6 5 4 3 2 1 0 
[ __Opeode +i + ‘Jiov]inc]oec]wany 


Bits 15 through 8 contain the opcode, and bit 7 = 1 defines the addressing mode 
as indirect. Bits 6 through 0 contain the indirect addressing control bits. 


Bit 6 contains the increment/decrement value (IDV). The IDV determines whether 
ARO will be used to increment or decrement the current auxiliary register. If bit 6 = 
0, an increment or decrement (if any) by one occurs to the current auxiliary register. 
If bit 6 = 1, ARO may be added to or subtracted from the current auxiliary register 
as defined by bits 5 and 4. 


Bits 5 and 4 control the arithmetic operation to be performed with AR(ARP) and 
ARO. When set, bit 5 indicates that an increment is to be performed. If bit 4 is set, a 
decrement is to be performed. Table 4-1 shows the correspondence of bit pattern 
and arithmetic operation. 
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Table 4-1. Indirect Addressing Arithmetic Operations 


BITS ARITHMETIC OPERATION 
5 


No operation on AR(ARP) 

AR(ARP) - 1 ~ AR(ARP) 

AR(ARP) + 1 ~~ AR(ARP) 

Not used 

AR(ARP) - ARO ~ AR(ARP) [reverse carry propagation] 
AR(ARP) - ARO ~ AR(ARP) 

AR(ARP) + ARO ~ AR(ARP) 

AR(ARP) + ARO ~ AR(ARP) [reverse carry propagation] 


4 
0 
1 
0 
1 
0 
1 
0 
1 


Bit 3 and bits 2 through O control the Auxiliary Register Pointer (ARP). Bit 3 (NAR) 
determines if a new value is loaded into the ARP. If bit 3 = 1, the contents of bits 
2 through O (Y = next ARP) are loaded into the ARP. If bit 3 = 0, the contents of 
the ARP remain unchanged. 


Table 4-2. Bit Fields for Indirect Addressing 


INSTRUCTION FIELD BITS NOTATION OPERATION 
163-44 AS Ste ea Ve: eee S48 2k OS 


OPCODE 
OPCODE 
OPCODE 
OPCODE 


OPCODE 
OPCODE 


OPCODE 


OPCODE 


OPCODE 
OPCODE 


OPCODE 
OPCODE 


OPCODE 
OPCODE 


No manipulation of ARs/ARP 
Y > ARP 

AR(ARP)-1 — AR(ARP) 
AR(ARP)-1 ~ AR(ARP); 

Y > ARP 

AR(ARP)+1 — AR(ARP) 
AR(ARP)+1 — AR(ARP); 

Y — ARP 

AR(ARP)-rcARO > AR(ARP)Tt 
AR(ARP)-rcARO ~ AR(ARP); 
Y > ARPT 

AR(ARP)-ARO — AR(ARP) 
AR(ARP)-ARO ~ AR(ARP); 

Y + ARP 

AR(ARP)+ARO > AR(ARP) 
AR(ARP)+ARO —~ AR(ARP); 
Y > -ARP 

AR(ARP)+rcARO > AR(ARP)T 
AR(ARP) +rcARO —~ AR(ARP); 
Y > ARPT 


Trc = reverse carry propagation 


For some instructions, the notation in Table 4-2 includes a shift code, e.g., *0+,8,3 
where 8 is the shift code and Y = 3. 


The CMPR (compare auxiliary register with ARO), and BBZ/BBNZ (branch if TC bit 
equal/not equal to zero) instructions facilitate conditional branches based on 
comparisons between the contents of ARO and the contents of AR(ARP). 


The auxiliary registers may also be used for temporary storage via the load and store 
auxiliary register instructions, LAR and SAR, respectively. 
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The following examples illustrate the indirect addressing format: 


Example 1: 


ADD *+,8 


15 14 13 


Add to the accumulator the contents of the data memory address 
defined by the contents of the current auxiliary register. This data 
is left-shifted 8 bits before being added. The current auxiliary 
register is autoincremented by one. The opcode is >Q8A0, as 
shown below. 


Ti ey eee = ee | Se RD 


ee a a ee a ee ee ee 


Example 2: 
ADD °*,8 


Example 3: 


ADD *-,8 


Example 4: 
ADD *0+,8 


Example 5: 
ADD “*0-,8 


Example 6: 


ADD *+,8,3 


Example 7: 


ADD *BRO-,8 


Example 8: 
ADD *BRO+,8 


As in Example 1, but with no autoincrement; the opcode is >0880. 


As in Example 1, except that the current auxiliary register is 
decremented by one; the opcode is >0890. 


As in Example 1, except that the contents of auxiliary register ARO 
are added to the current auxiliary register; the opcode is >O8E0. 


As in Example 1, except that the contents of auxiliary register ARO 
are subtracted from the current auxiliary register; the opcode is 
>O08D0O. 


As in Example 1, except that the auxiliary register pointer (ARP) 
is loaded with the value 3 for subsequent instructions; the opcode 
is >O8AB. 


The opcode is >O8CO. The contents of auxiliary register ARO are 
subtracted from the current auxiliary register with reverse carry 
propagation. 


The opcode is >O8FO. The contents of auxiliary register ARO are 
added to the current auxiliary register with reverse carry propa- 
gation. 
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4.1.3 Immediate Addressing Mode 


In immediate addressing, the instruction word(s) contains the value of the immediate 
operand. The immediate operand may be contained within the instruction word itself 
or in the word following the opcode. 


The following instructions contain the immediate operand in the instruction word 
and execute within a single instruction cycle. The length of the constant operand is 
instruction-dependent. 


ADDK 
ADRK 
LACK 
LARK 
LARP 
LDPK 
MPYK 
RPTK 
SBRK 


SUBK 


Add to accumulator short immediate (8-bit absolute constant) 

Add to auxiliary register short immediate (8-bit absolute constant ) 
Load accumulator immediate short (8-bit absolute constant) 

Load auxiliary register immediate short (8-bit absolute constant) 
Load auxiliary register pointer (3-bit constant) 

Load data memory page pointer immediate (9-bit constant) 
Multiply immediate (13-bit two’s-complement constant) 

Repeat instruction as specified by immediate value (8-bit constant) 


Subtract from auxiliary register short immediate (8-bit absolute 
constant) 


Subtract from accumulator short immediate (8-bit absolute constant). 


For the other immediate instructions, the constant is a 16-bit value in the word 
following the opcode. The 16-bit value can be optionally used as an absolute 
constant or as a two’s-complement value. 


ADLK 


ANDK 
LALK 


LRLK 
ORK 
SBLK 


XORK 


Add to accumulator long immediate with shift (absolute or two’s 
complement) 


AND immediate with accumulator with shift 


Load accumulator long immediate with shift (absolute or two’s 
complement) 


Load auxiliary register long immediate 
OR immediate with accumulator with shift 


Subtract from accumulator long immediate with shift (absolute or two’s 
complement) 


Exclusive-OR immediate with accumulator with shift. 


| 
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The following examples illustrate immediate addressing format: 
Example 1: 


ADLK 16384,2 Add to the accumulator the value 16384 with a shift to the left 
of two, effectively adding 65536 to the contents of the accu- 
mutator. 


The ADLK instruction uses the word following the instruction opcode as the imme- 
diate operand. The instruction format for ADLK is as follows: 


tS ge are © olen PR AD” a a : es aogier Seek” ieee eens Ne © 


16-Bit Constant 


Example 2: 
RPTK 99 _ Execute the instruction following this instruction 100 times. 


With the RPTK instruction, the immediate operand is contained as a part of the 
instruction opcode. The instruction format for RPTK is as follows: 


TO. 3a See. a ee ae reg ie i et ge og a. QD 


4.2 Instruction Set 


The following sections list the symbols and abbreviations used in the instruction set 
summary and in the instruction descriptions. The complete instruction set summary 
is Organized according to function. A detailed description of each instruction is listed 
in the instruction set summary. 


4.2.1 Symbols and Abbreviations 
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Table 4-3 lists symbols and abbreviations used in the instruction set summary (Table 
4-4) and the individual instruction descriptions. 
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Table 4-3. Instruction Symbols 


PSY RARGL) S25 sesoon ve ity MEANING =o, 


Accumulator 

Auxiliary register pointer buffer 

Auxiliary Register n (ARO through AR7 are predefined 
assembler symbols equal to 0 through 7, respectively.) 
Auxiliary register pointer 

4-bit field specifying a bit code 

Branch control input 

Carry bit 

2-bit field specifying compare mode 

On-chip RAM configuration control bit 

Data memory address field 

Label assigned to data memory location n 

Data memory address 

Data page pointer 

Format status bit 

Frame synchronization mode bit 

Hold mode bit 

Addressing mode bit 

Interrupt mode flag bit 

Immediate operand field 

Indicates nn is a hexadecimal number. (All others are 
assumed to be decimal values.) 

Overflow mode flag bit 

Overflow mode bit 

Product register 

Port address (PAO through PA15 are predefined assembler 
symbols equal to 0 through 15, respectively.) 
Program counter 

2-bit field specifying P register output shift code 
Program memory address 

Label assigned to program memory location n 
3-bit operand field specifying auxiliary register 
Repeat counter 

4-bit left-shift code 

Status register n (STO or ST1) 

Sign-extension mode bit 

Temporary register 

Test control bit 

Top of stack 

Transmit mode bit 

3-bit accumulator left-shift field 

XF pin status bit 

Is assigned to 

An absolute value 

User-defined items 

Optional items 

Contents of 

Alternative items, one of which must be entered 
Blanks or spaces must be entered where shown. 


4.2.2 Instruction Set Summary 


The instruction set summary of Table 4-4 is arranged according to function and 
alphabetized within each functional grouping. Additional information is presented 
in the individual instruction descriptions in the following section. The symbol T 
indicates instructions that are not included in the TMS32010 instruction set. The 
symbol ¢ indicates instructions that are not included in the TMS32020 instruction 
set. 
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Table 4-4. Instruction Set Summary 


ACCUMULATOR MEMORY REFERENCE INSTRUCTIONS 


_ INSTRUCTION BIT CODE 


MNEMONIC DESCRIPTION 
no 1412 12175106 98 7 6 & 43 2 1 0 
Absolute value of accumulator oS -O 9-01 - Oe cs 
Add to accumulator with shift mM —_)D—_———_> 
Add to accumulator with carry ee OS eee 
Add to high accumulator ——)—— 
Add to accumulator short immediate 
Add to low accumulator with sign 
extension suppressed 
Add to accumulator with shift specified by 
T register 
Add to accumulator long immediate with shift 
AND with accumulator 
AND immediate with accumulator with shift 
Complement accumulator 
Load accumulator with shift 
Load accumulator immediate short 
Load accumulator with shift specified by T register 
Load accumulator long immediate with shift 
Negate accumulator 
Normalize contents of accumulator 
OR with accumulator 
OR immediate with accumulator with shift 
Rotate accumulator left 
Rotate accumulator right 
Store high accumulator with shift 
Store low accumulator with shift 
Subtract from accumulator long immediate with shift 
Shift accumulator left 
Shift accumulator right 
Subtract from accumulator with shift 
Subtract from accumulator with borrow 
Conditional subtract 
Subtract from high accumulator 
Subtract from accumulator short immediate 


a ee ee ee ee es ) Oe eee ee ee 
oOo o:8 20 6:2 co Oo oO 2] = © 6.6 Oo: Oo:o © 2 oO = 6' 2 o-oo 
oO o 6 oOo Oo: = © 6 - Oo Oo Oo CO = 0 OC OO = 0 2. Oo 0 =| 2 — 


Subtract from low accumulator with sign 
extension suppressed 

Subtract from accumulator with shift specified by 
T register 

Exclusive-OR with accumulator 

Exclusive-OR immediate with accumulator with shift 
Zero accumulator . 

Zero low accumulator and load high accumulator 
Zero low accumulator and load high accumulator 
with rounding 

Zero accumulator and load low accumulator with 


sign extension suppressed 


TThese instructions are not included in the TMS32010 instruction set. 
tThese instructions are not included in the TMS32020 instruction set. 
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Table 4-4. Instruction Set Summary (Continued) 


AUXILIARY REGISTERS AND DATA PAGE POINTER INSTRUCTIONS 


INSTRUCTION BIT CODE 


15-14-13.12 17. 10:9 8 7 6 §$ 4 3 2 14:0 


NO. 


MNEMONIC DESCRIPTION 


Add to auxiliary register short immediate 


Compare auxiliary register with auxiliary register ARO 


Load auxiliary register 

Load auxiliary register short immediate 

Load auxiliary register pointer 

Load data memory page pointer 

Load data memory page pointer immediate 
Load auxiliary register long immediate 

Modify auxiliary register 

Store auxiliary register 

Subtract from auxiliary register short immediate 


=e seN 2232 2 6 | 


oo - - 020 - Oo — Oo 


oe) 


Se ee ee ee 


—-=}- OoOoodoodonoo0docododcs=. 0- 


T REGISTER, P REGISTER, AND MULTIPLY INSTRUCTIONS 


O 


000 1 ~<*R—-¥> 
———_ ) —____—__»> 


Os) Oi lee BP 
+R 0000000 0 


1 


ane 


e) 


1 


1 


<j --- I) 
Ge 


a a nr 


MNEMONIC 


DESCRIPTION 


NO. 
WORDS 


INSTRUCTION BIT CODE 


16:14.13:.12 11-109 5S 7 Ss. 43 2 1-0 
: 


APAC Add P register to accumulator 1 1. 1. eet Se ee ees eT 
LPHt Load high P register 1 01010011 1 <«<—D—— > 
LT Load T register 1 0 O° 1 1 PO OAT ———— i 
LTA Load T register and accumulate previous product 1 0.0.1.1. 17. 10-1 ta )D—_—— 
LTD Load T register, accumulate previous product, 1 mbt tf £1) ti oe 2 
and move data 

LTpPt Load T register and store P register in accumulator 1 00°T!T 14101 -—_——- 
Ltst Load T register and subtract previous product 1 010%1%10%1%1it4——D———-rx 
mMAct Multiply and accumulate 2 01011101 1 <——D———» 
MACDt Multiply and accumulate with data move 2 010111001 —D——7r 
MPY Multiply (with T register, store product in P register) 1 0 0 1 vhorttO 2500. trates) ——— 
MPYAt Multiply and accumulate previous product 1 0 0 1 4:e°%h0Q Aedes SD — 
MPYK Multiply immediate 1 101—_——_K———_——_—_—__> 
mMPYS# Multiply and subtract previous product 1 001110: tet —D)D——S 
MPYUt Multiply unsigned 1 1100111414 4 <—<——D—»> 
PAC Load accumulator with P register 1 1 18OoO0> heed: O10 (Ost 0-1 GAG 
SPAC Subtract P register from accumulator 1 1170 0 Tt Tee neers. 0 1 T36 
SPH? Store high P register 1 01111101 1 <———D———> 
SPLt Store low P register 1 O° Teste teeter. dete see —D re 
SPMt Set P register output shift mode 1 T 10 0 1 V-e60i1O1Gc:0is0 1 O4PR 
SQRAT Square and accumulate 1 00111001 hk —D—————-> 
sarst Square and subtract previous product 1 01031103104 <——D———> 


TThese instructions are not included in the TMS32010 instruction set. 
tThese instructions are not included in the TMS32020 instruction set. 


4-11 


j 
Assembly Language Instructions 


Table 4-4. Instruction Set Summary (Continued) 


BRANCH/CALL INSTRUCTIONS 


MNEMONIC | NO. INSTRUCTION BIT CODE 
WORDS 


1514131211109 8765 43210 


B Branch unconditionally 2 1713171414979 1% 3134%313e—Dp—> 
BACCt Branch to address specified by accumulator 1 Rite Oates AsO sOetcs 0°11 84 
BANZ Branch on auxiliary register not zero 2 11713114 31%0%141%31 4——D— > 
BBNzt Branch if TC bit + O 2 111110011 «——D—» 
BBzt Branch if TC bit = O 2 111110001 <«——D——» 
Bct Branch on carry 2 010111101 «+——\p)—— >» 
BGEZ Branch if accumulator > O 2 11174310e43100%1e——D)— > 
BGZ Branch if accumulator > O 2 11131400011 —D-> 
BIOZ Branch on I/O status = O 2 11113103031 —D)-——— > 
BLEZ Branch if accumulator < O 2 111100101 .-——)D-——> 
BLZ Branch if accumulator < O 2 1117431003314 1<«——)D—-—> 
BNCt Branch on no carry 2 010111114 1 <———OD——»> 
BNvt Branch if no overflow 2 111101411 1«+——pD—\» 
BNZ Branch if accumulator + O 2 11.1.4.0141011e——D0--—— > 
BV Branch on overflow 2 14111000 01 —_——)-——\)> 
BZ Branch if accumulator = O 2 1113104314101 «——D)——», 
CALA Call subroutine indirect 1 1 ee ee, 8 ee 0 aie 
CALL Call subroutine 2 11143113141 10%1e—_——D\)D—_———P 
RET Return from subroutine 1 1. oe ee A ee 


1/0 AND DATA MEMORY OPERATIONS 


MNEMONIC asiiciabieiinis NO. INSTRUCTION BIT CODE 
WORDS 


1514131211109 8 765 43210 


BLKD Block move from data memory to data memory 2 113171431314 %1%0310800@—D—> 
BLKPT Block move from program memory to data memory 2 1131313%%313%%1%00t10}———D—P> 
DMOV Data move in data memory 1 01057101101 D)D——> 
FORT! Format serial port registers 1 1 4200cO-1e:F 2s 56: 6::0e0. 1. 1° 40FD 
IN Input data from port 1 1000— <<—PA—> | <«<—D)D——— 
OUT Output data to port 1 11310 <aPA—_ | <——)D—> 
RFSM+ Reset serial port frame synchronization mode 1 tL t.0 0-1 See: Gries Oo 1°89 
RTXMt Reset serial port transmit mode 1 21 Oi Oi 4D 0-0 020 
RXFT Reset external flag 1 PietinOsOs 4.01. .4480 0200 1 1 Oe 
SFSM+ Set serial port frame synchronization mode 1 1 ©. Brtiaeseee ott CO 1. 
STXM!t Set serial port transmit mode 1 t 1.060 0.17. ite Bose store 0.0 04 
SXFT Set external flag 1 1. teense ite Aetic GOGO O01 1 OMI 
TBLR Table read 1 010110001 #——D)D— > 
TBLW Table write 1 010110014++.—D)——— >» 


TThese instructions are not included in the TMS32010 instruction set. 
+tThese instructions are not included in the TMS32020 instruction set. 


Assembly Language Instructions 


Table 4-4. Instruction Set Summary (Concluded) 


CONTROL INSTRUCTIONS 


NO. INSTRUCTION BIT CODE 
WORDS 


MNEMONIC DESCRIPTION 

1514131211109 8 76543 210 
BIT Test bit 1 100%1~<«—B—r | <«—)D— > 
BITTT Test bit specified by T register 1 010103111 1 <«<——D—— > 
CNFDt Configure block as data memory 1 to 8 tt ORO ee BT ee 
CNFPTt Configure block as program memory 1 Ake OD a EG OD Oe Ot 
DINT Disable interrupt 1 Lat oe FT 1-O 0.0 aaa es. 1 
EINT Enable interrupt 1 aoe ae” he Le OC OO Se Oo. 8 8 
IDLETt Idle until interrupt 1 Poe ee ee Re ea he Poe 
LST Load status register STO 1 0 +7°0.1-0;0 00 | «#—D— > 
LsT1? Load status register ST1 1 070 10001it1——D—> 
NOP No operation 1 ond se oTeyy 1 O:-1--0.0-0 0 09 0 OG OB 
POP Pop top of stack to low accumulator 1 1 eo Td eae 8 Bit. 2 BI 
Poppt Pop top of stack to data memory 1 Or 1414.0101 D> 
PSHDt Push data memory value onto stack 1 Oit- Ooo: -+ 0 0. |. ——)———-> 
PUSH Push low accumulator onto stack 1 Po eee he eo ee eS a ee 
Rct Reset carry bit 1 1¢ OSE ti 14 1 0 0.-0-1-1-0°0 0.0 
RHM# Reset hold mode 1 SIP aN 4 1 0.0 0-1-4. t.9-0°0 
ROVM Reset overflow mode 1 i tee lt Oe OO Oe. OG: 7 
RPTT Repeat instruction as specified by data memory value 1 01001011 il «&———D—> 
RPTKT Repeat instruction as specified by immediate value 1 1.1.0.0.%1011~”}—_——K—_— > 
RSxmMt Reset sign-extension mode 1 a tO Oo 7. to ee Oe 7 tes 
RTCH Reset test/control flag 1 neese i 1 + 80 01-70 0°1:°0 
sct Set carry bit 1 FeFIONO IH 1 1000.11.00 0 1 
SHM# Set hold mode 1 reife 1 1 6 8 O44 TO 0.4 
SOVM Set overflow mode 1 a? toe ee OE OO oe Oo Oe Oe 
SST Store status register STO 1 0111171 OOOl *——D)D—> 
ssTit Store status register ST1 1 0111100311 «——\D——~> 
Sssxmt Set sign-extension mode 1 en 1 ee OD Oe 
stct Set test/control flag 1 4. etitiondal to -7 ae 1 10-6. FI 
TRAPT Software interrupt 1 eo eee 4 - h  e  F 


tThese instructions are not included in the TMS32010 instruction set. 
These instructions are not included in the TMS32020 instruction set. 


4.3 Individual Instruction Descriptions 


Each instruction in the instruction set summary is described in the following pages. 
Instructions are listed in alphabetical order. Information, such as assembler syntax, 
operands, operation, encoding, description, words, cycles, repeatability, and exam- 
ples, is provided for each instruction. An example instruction is provided to familiarize 
the user with the special format used and explain its content. Refer to Section 4.1 
for further information on memory addressing. Code examples using many of the 
instructions are given in Section 5 on Software Applications. 


4-13 


XAMPL 


Direct Addressing: 
Indirect Addressing: 
Immediate Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Short Immediate 


Long Immediate 


Example Instruction EXAMPLE 


[<label>] EXAMPLE <dma>[,<shift>] 
[<label>] EXAMPLE {*|*+|*-|*0+]|*0-|*BRO+|*BRO-}[,<shift> [,<nextARP>]] 
[<label>] EXAMPLE [<constant>] 


Each instruction begins with an assembler syntax expression. The optional 
comment field that concludes the syntax is not included in the syntax expression. 
Space(s) are required between each field (label, command, operand, and 
comment fields) as shown in the syntax. The syntax example illustrates both direct 
and indirect addressing, as well as immediate addressing in which the operand 
field includes <constant>. 


0 < dma < 127 
0 < next ARP < 7 
0 < constant < 255 


Operands may be constants or assembly-time expressions referring to memory, 
|/O and register addresses, pointers, shift counts, and a variety of constants. The 
operand values used in the example syntax are shown. 


(PC) +17 PC 
(ACC) + [(dma) x 2shift} + ACC 


If SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 
Then (dma) is not sign-extended. 


Affects C and OV; affected by OVM and SXM. 


This section provides an example of the instruction operation sequence, describing 
the processing that takes place when the instruction is executed. Conditional 
effects of status register specified modes are also given. In addition, those bits in 
the status registers that are affected by the instruction are listed. 


pt: ee gi Mey 5 oie eee 8 See eg me em Sack da Salo” ae a 


Se ae: oe Data Memory Address 


V+" Poe eee | Oe Oe 8 e 4) 8 
16-Bit Constant 


Opcode examples are shown of both direct and indirect addressing or of the use 
of short or long immediate operands. 


EXAMPLE Example Instruction : EXAMPLE 


Description 


Words 


Cycles 


Repeatability 


Example 


This section decribes the instruction execution and its effect on the rest of the 
processor or memory contents. Any constraints on the operands imposed by the 
processor or the assembler are also described here. The description parallels and 
supplements the information given by the execution block. 


1 


The digit specifies the number of memory words required to store the instruction 
and its extension words. 


Class | (1) 


Instructions are classified according to the number of cycles required for each 
instruction. The single digit value enclosed in parentheses represents the cycle 
execution time of the instruction when not repeated. The instruction is assumed 
to be executed from on-chip ROM and use on-chip RAM. Repeatable multicycle 
instructions will execute in one cycle on all repeat executions. Refer to Appendix 
E for detailed information on instruction cycle timings. 


Category B 


The repeatability of each instruction (using RPT or RPTK) is classified as to A, 
B, C, or X according to the following: 


A Instruction repeatable; useful if repeated. 
B Instruction repeatable; may be of some use if repeated. 
C Instruction repeatable; not useful to repeat the instruction. 
X Instruction not repeatable. 

ADD DAT1,3 (DP = 10) 

or 

ADD * 3 If current auxiliary register contains 1281. 

Before Instruction After Instruction 
Data Data 
Memory Memory 

1281 1281 


acc nce fo] [a] 
C C 


The sample code presented in the above format shows the effect of the code on 
memory and/or registers. 


ABS 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Absolute Value of Accumulator ABS 


[<label>] ABS 


None 
(PC) 1 =-PC 
|(ACC)| > ACC 


Affects C and OV; affected by OVM. 
Not affected by SXM. 


Vo ae 1S coheke eNO Seer ete ee. ee Se 1G 
1 1 Oe 1 tet ee to ee 1 


If the contents of the accumulator are greater than or equal to zero, the accu- 
mulator is unchanged by the execution of ABS. If the contents of the accumulator 
is less than zero, the accumulator is replaced by its two’s-complement value. 


Note that >80000000 is a special case. When the overflow mode is not set, the 
ABS of >80000000 is >80000000. When in the overflow mode, the ABS of 
>80000000 is >7FFFFFFF. In either case, the OV status bit is set. Also note that 
the carry bit C is always reset to zero by the execution of this instruction. 


1 


Class IV (1) 
Category C 
ABS 
Before Instruction After Instruction 
ACC >1234 acc [0 >1234 
S C 
Acc SFFFFFFEF acc [0] 
if C 


ADD 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


Add to Accumulator with Shift ADD 


[<label>] ADD <dma>,[<shift>] 
[<label>] ADD {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<shift>[,<next ARP>]] 


O < dma < 127 
O < next ARP < 7 
0 < shift < 15 (defaults to 0) 


(PC) +17PC | 
(ACC) + [(dma) x 28hift] + ACC 


If SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 


Then (dma) is not sign-extended. 
Affects C and OV; affected by OVM and SXM. 
ye Se > eee ee oe ee ee cee ee ee ee ee 0 


Oeo 1G vie-a0 Pots Giaiiss <<) 4. is Data Memory Address 
OF HOME See Section 4.1 


The contents of the addressed data memory location are left-shifted and added 
to the accumulator. During shifting, low-order bits are zero-filled. High-order 
bits are sign-extended if SXM = 1 and zero-filled if SXM = 0. The result is stored 
in the accumulator. 


1 

Class | (1) 

Category A 

ADD DAT1,3 (DP = 10) 

or 

ADD 3,3 If current auxiliary register contains 1281. 

Before Instruction After Instruction 

Data Data 

Memory Memory 
1281 1281 


ACC acc [0 >42 


ADDC Add to Accumulator with Carry ADDC 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 


[<label>] ADDC <dma> 
[<label>] ADDC {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(Pi 1 PC 
(ACC) + (dma) + (C) ~ ACC 


Affects C and OV; affected by OVM. 
18: 14 > 13: 122341: .bb@nehe suc fet fame 40° S| 2-1. 0 


ees ee ee ee SS Data Memory Address 
Obetgetts VE pa See Section 4.1 


The contents of the addressed data memory location and the value of the carry 
bit are added to the accumulator. The carry bit is then affected in the normal 
manner. 


The ADDC instruction can be used in performing multiple-precision arithmetic. 


1 


Class | (1) 
Category B 
ADDC DAT5 (DP = 8) 
or 
ADDS: <* If current auxiliary register contains 1029. 
Before Instruction After Instruction 
Data Data 
Memory Memory 
1029 1029 
acc Ta] ace fp 
os C 
ADDC DAT5 (DP = 8) 
or 
ADDC * If current auxiliary register contains 1029. 
Before Instruction After Instruction 
Data Data 


1029 


C 


C 


ADDH Add to High Accumulator ADDH 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] ADDH <dma> 
[<label>] ADDH {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(PC) +1-7PC 
(ACC) + [(dma) x 216] > ACC 


Affects C and OV; affected by OVM. 
Low-order bits of the ACC not affected. 


Ve ke ee ee ea a 


Ooniit Ostn@acst GBs Data Memory Address 
eS ee ee ee Se Se SS See Section 4.1 


The contents of the addressed data memory location are added to the upper half 
of the accumulator (bits 31 through 16). Low-order bits are unaffected by ADDH. 
The carry bit C is set if the result of the addition generates a carry; otherwise, C 
is unaffected. The carry bit can only be set, not reset, by the ADDH instruction. 


The ADDH instruction may be used in performing 32-bit arithmetic. 


1 
Class | (1) 
Category B 


ADDH DAT5 (DP = 8) 


ADDH * If current auxiliary register contains 1029. 
Before Instruction After Instruction 
Data Data 
Memory Memory 
1029 1029 
ACC >13 ACC >40013 
ie » 


ADDK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-20 


Add to Accumulator Short Immediate ADDK 


[<label>] ADDK <constant> 


0 < constant < 255 


(PC)-+ Tt 2 PC 
(ACC) + 8-bit positive constant ~ ACC 


Affects C and OV: affected by OVM. 
Not affected by SXM. 


te 14- 13 ea 8 a8 bec Spe Sse 4 3G CUZ 8 


110 OTF 40 Ol BR Consent 


The 8-bit immediate value is added, right-justified, to the accumulator with the 
result replacing the accumulator contents. The immediate value is treated as an 
8-bit positive number, regardless of the value of SXM. 


1 
Class IV (1) 
Category X 
ADDK >5 
Before Instruction After Instruction 
ACC >79B2E1 acc [0] S7IOGB2ZES 
C Cc 


ADDS Add to Accumulator with Sign-Extension Suppressed ADDS 


Assembler Syntax 
Direct Addressing: [<label>] ADDS <dma> 
Indirect Addressing: [<label>] ADDS {*|*+]|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP s 7 
Execution (PG) +1 Fo 


(ACC) + (dma) ~ ACC 
(dma) is a 16-bit unsigned number. 


Affects C and OV; affected by OVM. 
Not affected by SXM. 


Encoding te ee Be ORT ae a i oe OD 


Direct + Se a ee os eee 7 Data Memory Address 
industi.0 1 610 1 © 0 a| 4. See Section 4.1 


Description The contents of the specified data memory location are added with sign-extension 
suppressed. The data is treated as a 16-bit unsigned number, regardless of SXM. 
The accumulator behaves as a signed number. Note that ADDS produces the 
same results as an ADD instruction with SXM = 0 and a shift count of 0. 


Words 1 
Cycles Class | (1) 
Repeatability Category B 
Example ADDS DAT11 (DP = 6) 
or 
ADDS * If current auxiliary register contains 779. 
Before Instruction After Instruction 
Data Data 
Memory >FO00O6 Memory >FOO6 
779 779 
Acc acc [o] >F009 
GC C 


ADDT Add to Accumulator with Shift Specified by T Register ADDT 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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[<label>] ADDT <dma> 
[<label>] ADDT {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 

O < next ARP < 7 

(PC) +1 > PC | 

(ACC) + [(dma) x 2! register(3-0)] + (ACC) 


If SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 
Then (dma) is not sign-extended. 


Affects C and OV; affected by SXM and OVM. 
gE Rian CR Pees oS hy ae 8 I” ee eee ae Ag ee ee eee 2 ae ame © 


6 4501 Dit Oo tele Data Memory Address 
OsndercOs ais eb bere ee Pde d | See Section 4.1 


The data memory value, left-shifted as defined by the four LSBs of the T register, 
is added to the accumulator, with the result replacing the accumulator contents. 
Sign extension on the data memory value is controlled by SXM. 


1 


Class | (1) 

Category A 

ADDT DAT127 (DP = 4) 

or 

ADDT * If current auxiliary register contains 639. 

Before Instruction After Instruction 

Data Data 

Memory > Memory 


639 


ADLK Add to Accumulator Long Immediate with Shift ADLK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] ADLK <constant>([,<shift>] 


16-bit constant 
O < shift < 15 (defaults to 0) 


(PC) +2 > PC | 
(ACC) + [constant x 2Shift] + ACC 


lf SXM = 1: 
Then -32768 < constant < 32767. 
lf SXM = 0: 


Then O < constant < 65535. 
Affects C and OV; affected by OVM and SXM. 
8. 18 78. 82. Te Bw Bt BR eee Bae AB ae 


1 7 0 1] Shit =| @ 0122000 0 0 tee 
16-bit Constant 


The 16-bit immediate value, left-shifted as specified, is added to the accumulator. 
The result replaces the accumulator contents. SXM determines whether the 
constant is treated as a signed two’s-complement number or as an unsigned 
number. The shift count is optional and defaults to zero. 


2 
Class V (2) 
Category X 
ADLK 5,8 
Before Instruction After Instruction 
ACC >10EF acc [0] >15EF 
C is 
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ADRK Add to Auxiliary Register Short Immediate ADRK 


Assembler Syntax [<label>] ADRK <constant> 


Operands O < constant < 255 
Execution (PGi. + + 7 eo 
AR(ARP) + 8-bit positive constant ~ AR(ARP) 
Encoding eo: GS Lace eS ee Se Os ee a i Be Par: Ao 
7 7.1 ot te 
Description The 8-bit immediate value is added, right-justified, to the currently selected 


auxiliary register with the result replacing the auxiliary register contents. The 
addition takes place in the ARAU, with the immediate value treated as an 8-bit 
positive integer. 


Words 1 

Cycles Class IV (1) 

Repeatability Category X 

Example ADRK >80 (ARP = 5) 


Before Instruction After Instruction 


AR5 >4321 AR5 >43A1 


4-24 


AND 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


AND with Accumulator AND 


[<label>] AND <dma> 
[<label>] AND {*|*+|*-|*0+/*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(PO) + 4.7 PC 
(ACC(15-0)).AND.(dma) ~ ACC(15-0) 
0 ~ ACC(31-16) 

Not affected by SXM. 


ee fee © ee ae Be eee ft i: Ree ee See ee ee Pe ee eee 


Direct a Ee 2 ies § ARR 1 1 0 Data Memory Address 


Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


OLeruMQIIS OTT alsa yc GETTY See Section 4.1 


The lower half of the accumulator is ANDed with the contents of the addressed 
data memory location. The upper half of the accumulator is ANDed with all zeroes. 
Therefore, the upper half of the accumulator is always zeroed by the AND 
instruction. 


1 


Class | (1) 
Category B 
AND DAT16 (DP =. 2) 
or 
AND * If current auxiliary register contains 528. 
Before Instruction After Instruction 
Data Data 
Memory >F FE Memory i - 
528 528 
ACC >12345678 ACC >00000078 
C e 


ANDK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-26 


AND Immediate with Accumulator with Shift ANDK 


[<label>] ANDK <constant>[,<shift>] 


16-bit constant 
O < shift < 15 (defaults to 0) 


(PC) +2 > PC 


(ACC(30-0)).AND.[(constant x 2Shift)] + ACC(30-0) 
0 ~ ACC(31) and all other bit positions not occupied by the shifted constant. 


Not affected by SXM. 
15: -94...13 12-210. 10 -- Swe aieseas eee OS CUA TOO 


ee ae RE Cee ee a ee ee oe ae ae 
16-bit Constant 


The 16-bit immediate constant is left-shifted as specified and ANDed with the 
accumulator. The result is left in the accumulator. Low-order bits below and 
high-order bits above the shifted value are treated as zeroes, clearing the corre- 
sponding bits in the accumulator. Note that the accumulator’s most-significant 
bit is always zeroed regardless of the shift-code value. 


2 
Class V (2) 
Category X 
ANDK >FFFF,12 
Before Instruction After Instruction 
ACC >12345678 ACC >02345000 
i C 


APAC Add P Register to Accumulator APAC 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] APAC 


None 


(PC). +.1.>PC 
(ACC) + (shifted P register) ~ ACC 


Affects C and OV; affected by PM and OVM. 
Not affected by SXM. 


1 eS GO 5 EY OS Of i es en ce eee aos a ae: Oe a ace | 
er a a remy rey 


The contents of the P register are shifted as defined by the PM status bits and 
added to the contents of the accumulator. The result is left in the accumulator. 
APAC is not affected by the SXM bit of the status register; the P register is always 
sign-extended. Note that APAC is a subset of the LTA, LTD, MAC, MACD, MPYA, 
and SORA instructions. 


1 
Class IV (1) 
Category B 
APAC (PM = 0) 
Before Instruction After Instruction 
ACC >20 acc [0] >6 0 
C i 
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B Branch Unconditionally B 


Assembler Syntax [<label>] B <pma>[,{*|*+]|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


Operands O < pma < 65535 
O < next ARP < 7 


Execution pma ~ PC 
Modify AR(ARP) and ARP as specified. 


Encoding 1D. 14. \3-2122 11.50 Se Peoria ey 4 oS 2 oT 8 


1 1 1 1 1 1 1 1 1 See Section 4.1 
Program Memory Address 


Description The current auxiliary register and ARP are modified as specified, and control 
passes to the designated program memory address (pma). Note that no AR or 
ARP modification occurs if nothing is specified in those fields. Pma can be either 
a symbolic or a numeric address. 


Words 2 

Cycles Class VIII (3) 

Repeatability Category X 

Example B PRG191 191 is loaded into the program counter, and 
the program continues running from that 
location. 
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BACC Branch to Address Specified by Accumulator BACC 


Assembler Syntax [<label>] BACC 


Operands None 
Execution (ACC(15-0)) > PC 
Encoding 15.° 14. .13 «12. Tt: 10 9-H Pewee 4 2. 2.1.. 0 
1 1 é a * 1 1 OA es 9 0 1 
Description The branch uses the lower half of the accumulator (bits 15-0) for the branch 
address. 
Words 1 
Cycles Class VIII (3) 
Repeatability Category X 
Example BACC 
Before Instruction After Instruction 


PC >16E4 PC >9545 
ACC SFTREFO546 ACC >F7EFEOS4E 


C C 
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BANZ Branch on Auxiliary Register Not Zero BANZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 
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[<label>] 


BANZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


0 < pma < 65535 
O < next ARP < 7 


If AR(ARP) # 0: 
Then pma ~> PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) as specified. 


15 
1 


ho Sear at aa oe 
1 1 5 O° eg 


Program Memory Address 


< ee Ae oS 


See Section 4.1 


Control is passed to the designated program memory address (pma) if the current 


auxiliary register is not equal to zero. 


Otherwise, control passes to the next 


instruction. The current auxiliary register and ARP are also modified as specified. 


The current auxiliary register is either incremented or decremented from zero when 
the branch is not taken. Note that the AR modification defaults to *- (decrement 
current AR by one) when nothing is specified, making it compatible with the 
TMS32010. Pma can be either a symbolic or a numeric address. 


2 
Class VII (3) 
Category X 
BANZ PRG35,*- 
Before Instruction 
Ar 
PC ee 
or 
an 
PC >46 
BANZ PRG64, *+ 
Before Instruction 
AR >FRFFFE 
PC 
or 
AR 
PC 


AR 


PC 


AR 


PC 


AR 


PC 


AR 


PC 


After Instruction 


V 


V 
Ww 
o1 =) 


>FFFF 


V 
£ 
00 


After Instruction 


V 
© 


Vv 
V [e>) 
= 5 


>119 


BANZ Branch on Auxiliary Register Not Zero BANZ 


Note: 


BANZ is designed for loop control using the auxiliary registers as loop coun- 
ters. Using “0+ or *0- allows modification of the loop counter by a variable 


step size. Care must be exercised when doing this, however, because the 
auxiliary registers behave as modulo 65536 counters, and zero may be passed 
without being detected if ARO > 1. 
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BBNZ Branch on Bit Not Equal to Zero BBNZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-32 


[<label>] BBNZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


0 < pma < 65535 
O < next ARP < 7 


If test/control (TC) status bit = 1: 
Then pma ~ PC; 
Else (PC) + 2 > PC. 
Modify AR (ARP) and ARP as specified. 


Affected by TC. 
+ Oe eS aed ee ee ee Oe ee Bee Ee. O 


1 1 1 1 1 > Se > Sa 1 See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if TC = 1. Otherwise, control 
passes to the next instruction. Note that no AR or ARP modification occurs if 
nothing is specified in those fields. Pma can be either a symbolic or a numeric 
address. Note that the TC bit may be affected by the BIT, BITT, CMPR, LST1, 
NORM, RTC, and STC instructions. 


2 

Class VII (3) 

Category X 

BBNZ PRG650 If TC = 1, 650 is loaded into the program 


counter; otherwise, the program counter 
is incremented by 2. 


BBZ Branch on Bit Equal to Zero BBZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] BBZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


O < pma < 65535 
O < next ARP < 7 


If test/control (TC) status bit = 0: 
Then pma > PC; 
Fise: (PC) + 2 PC, 
Modify AR(ARP) and ARP as specified. 


Affected by TC bit. 
S&S WwW 2 RM Mm. Ss .- 8 SMe SB 4 38 2: otted 


1 1 1 1 1 oS Bw Go See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if TC = 0. Otherwise, control 
passes to the next instruction. No AR or ARP modification occurs if nothing is 
specified in those fields. Pma can be either a symbolic or a numeric address. 
Note that the TC bit is affected by the BIT, BITT, CMPR, LST1, NORM, RTC, and 
STC instructions. 


2 

Class VII (3) 

Category X 

BBZ PRG325 If TC = 0, 325 is loaded into the program 


counter; otherwise, the program counter 
is incremented by 2. 
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BC Branch on Carry BC 


Assembler Syntax [<label>] BC <pma>([,{*|*+|*-|*0+|*0O-|*BRO+|*BRO-}[,<next ARP>]] 


Operands 0 < pma < 65535 
O < next ARP < 7 


Execution If carry bit C = 1: 
Then pma > PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. 


Affected by C. 
Encoding 34. V3... 32 H... AG. Be SS. a. ae SK Se 2. OD 


| ee 0 4 1 1 1 ee See Section 4.1 
Program Memory Address 


Description The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the carry bit C = 1. Other- 
wise, control passes to the next instruction. Note that no AR or ARP modification 
occurs if nothing is specified in those fields. Pma can be either a symbolic or a 
numeric address. 


Note that the carry bit C is affected by all add, subtract, and accumulate 
instructions as well as the ABS, LST1, NEG, RC, SC, rotate, and shift instructions. 
The carry bit is not affected by execution of BC, BNC, or nonarithmetic 
instructions. 


Words 2 

Cycles Class VII (3) 

Repeatability Category X 

Example BC PRG512 if the carry bit:.¢ = 1,512 is leaded into 


the program counter; otherwise, the program 
counter is incremented by 2. 
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BGEZ Branch if Accumulator Greater Than or Equal to Zero BGEZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] BGEZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


O < pma < 65535 
O < next ARP < 7 


If (ACC) > 0: 
Then pma > PC; 
Eise (PC) +2 PC. 
Modify AR (ARP) and ARP as specified. 


Oo} eS. eR ee a a Se ee 0 


1 1 1 1 tes: wo. See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are greater than or equal to zero. Otherwise, control passes to the next 
instruction. Note that no AR or ARP modification occurs if nothing is specified 
in those fields. Pma can be either a symbolic or a numeric address. 


2 

Class VII (3) 

Category X 

BGEZ PRG217 217 is loaded into the program counter if 
the accumulator is greater than or equal 
to zero. 
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BGZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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Branch if Accumulator Greater Than Zero BGZ 


[<label>] BGZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


0 < pma < 65535 
0 < next ARP < 7 


If (ACC) > 0: 
Then pma ~> PC; 
Else- {PC) +2 PC. 
Modify AR(ARP) and ARP as specified. 


te. T8338 ae Te a ae a ee A 2 REM 


1 1 1 1 5 me: eames 2 ame 1 See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are greater than zero. Otherwise, control passes to the next instruction. 


_Note that no AR or ARP modification occurs if nothing is specified in those fields. 


Pma can be either a symbolic or a numeric address. 


z 

Class VII (3) 

Category X 

BGZ PRG342 342 is loaded into the program counter if 


the accumulator is greater than zero. 


BIOZ Branch on I/O Status Equal to Zero BIOZ 


Assembler Syntax [<label>] BIOZ <pma>[,{*|*+|*-|*0+|*0-|*"BRO+|*BRO-}[,<next ARP>]] 


Operands O < pma < 65535 
O < next ARP < 7 


Execution If BIO = 0: 
Then pma > PC; 
Else (PC) + 2.-7-PC. 
Modify AR(ARP) and ARP as specified. 


Encoding 15 2. TS Te Ie Be Ba ea a ee 


1 1 1 1 1 eee a See Section 4.1 
Program Memory Address 


Description The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the BIO pin is low. Other- 
wise, control passes to the next instruction. Note that no AR or ARP modification 
occurs if nothing is specified in those fields. Pma can be either a symbolic or a 
numeric address. 


BIOZ in conjunction with the BIO pin can be used to test if a peripheral is ready 
to send or receive data. Polling the BIO pin using BIOZ may be preferable to an 
interrupt when executing time-critical loops. 


Words 2 

Cycles Class VII (3) 

Repeatability Category X 

Example BIOZ PRG64 If the BIO- pin is active (low), then 


a branch to location 64 occurs. 
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BIT 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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Test Bit ‘BIT 


[<label>] BIT <dma>,<bit code> 
[<label>] BIT {*|*+|*-|*0+|*0-|*BRO+|*BRO-},<bit code>[,<next ARP>] 


O < dma < 127 
O < ARP <7 
0 < bit code < 15 


(Pi +) oe 
(dma bit at bit address (15-bit code)) > TC. 


Affects TC. 
ye Dy Me gc: Roi ieee oe: a en ie: ee Ys cee 2 


1 i 1}  BitCode | Data Memory Address 
1 ee Grek See Section 4.1 


The BIT instruction copies the specified bit of the data memory value to the TC 
bit of status register ST1. Note that the BITT, CMPR, LST1, and NORM 
instructions also affect the TC bit in status register ST1. A bit code value is 
specified that corresponds to a certain bit address in the instruction, as given by 
the following table: 


Bit Code 
Bit Address 1110 9 8 
(LSB) 0 Be CE 
1 5 ESS gee one 9. 
2 : ie ea? 
3 Hae, ea 
4 7 48 
5 cae” ae ae | 
6 1°02: 
7 1 oo 9 
8 O49 
9 a t-9 
10 8 4 
11 O-} oa 
12 001 1 
13 6.0: 18 
14 0 G7 
(MSB) 15 0000 
1 
Class | (1) 
Category C 
BIT 70,78 (DP = 488) 
or 
BIT x 8 If current auxiliary register contains >F400. 
Before Instruction After Instruction 
Data Data 
Memory >7E Ss Memory >7ESS 
>F400 >F400 
rc rc 


BITT Test Bit Specified by T Register BITT 


Assembler Syntax 
Direct Addressing: [<label>] BITT <dma> 
Indirect Addressing: [<label>] BITT {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution to. ae eee a © 
(dma bit at bit address (15-T register(3-0))) > TC 
Affects TC. 
Encoding 16-44-4312 -- 4 40 8-8-7 --- 6 65 A 3lUCU. 70 


Direct G---1 o- ~-7 G4 1 1 Data Memory Address 
pidnacd f epetuyes goa! CCCP Seen esp: Be See Section 4.1 


Description The BITT instruction copies the specified bit of the data memory value to the TC 
bit of status register ST1. Note that the BIT, CMPR, LST1, and NORM instructions 
also affect the TC bit in status register ST1. The bit address is specified by a bit 
code value contained in the LSBs of the T register, as given in the following table: 


Bit Code 
Bit Address 23140 
(LSB) 0 1441 
1 1) 9 
z j fe eS a | 
3 i-t 8-9 
4 * 424 4 
5 eS oe ae 
6 1 Oo 7 
Fj 1000 
8 te ee ae 
9 0.70 
10 010 1 
11 0100 
12 D 64 
13 0010 
14 0001 
(MSB) 15 0000 
Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example BITT >0 Value in T register points to bit 14 of 
data word (DP = 240). 
or 
BITT " If current auxiliary register contains >7800. 
Before Instruction After Instruction 
Data Data 
Memory >4DC8 Memory >4DC8 
>7800 >7800 


TR TR : 


is 
— 
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BLEZ Branch if Accumulator Less Than or Equal to Zero BLEZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-40 


[<label>] BLEZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>j}». 


O < pma < 65535 
O < next ARP < 7 


If (ACC) < 0: 
Then pma > PC; 
Eise {PC) + 2 = PC. 
Modify AR(ARP) and ARP as specified. 


Dery «aan nS Spiers oe acs © ieee 2 Dies’ ee Meee Set oS co) ee, See Se a a 8 


1 1 1 1 ay 3 ea See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are less than or equal to zero. Otherwise, control passes to the next 
instruction. Note that no AR or ARP modification occurs if nothing is specified 
in those fields. Pma can be either a symbolic or a numeric address. 


2 

Class VII (3) 

Category X 

BLEZ PRG63 63 is loaded into the program counter if the 


accumulator is less than or equal to zero. 


BLKD Block Move from Data Memory to Data Memory BLKD 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Direct 


Indirect 


[<label>] BLKD <dma1>,<dma2> 
[<label>] BLKD <dmat1>,{*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 65535 
0 < dma2 < 127 
O < next ARP < 7 


(PC) +27 PC 
(PFC) > MCS 
(dma1) > PFC 


While (repeat counter) # 0: 
(dma, addressed by PFC) ~ dma2, 
Modify AR(ARP) and ARP as specified, 
(PFC) + 1 > PFC, 
(repeat counter) - 1 ~ repeat counter. 


(dma1, addressed by PFC) ~ dma2 
Modify AR(ARP) and ARP as specified. 
(MCS) ~ PFC 


6 14. 12: 12. 41.-10--: 2 8 7. S522 4.3. 2. To 8 


Re Ge a ee Ses ee eS Data Memory Address 2 
Data Memory Address 1 


1 1 1 1 1 1 0 81 See Section 4.1 
Data Memory Address 1 


Consecutive memory words are moved from a source data memory block to a 
destination data memory block. The starting address (lowest) of the source block 
is defined by the second word of the instruction. The starting address of the 
destination block is defined by either the dma contained in the opcode (for direct 
addressing) or the current AR (for indirect addressing). In the indirect addressing 
mode, both the current AR and ARP may be modified in the usual manner. In the 
direct addressing mode, dma2 is used as the destination address for the block 
move but is not modified upon repeated executions of the instruction. Thus, the 
contents of memory at the dma2 address will be the same as the contents of 
memory at the last dma1 address in a repeat sequence. ) 


RPT or RPTK must be used with this instruction, in the indirect addressing mode, 
if more than one word is to be moved. The number of words to be moved is one 
greater than the number contained in the repeat counter RPTC at the beginning 
of the instruction. At the end of this instruction, the RPTC contains zero and, if 
using indirect addressing, AR(ARP) will be modified to contain the address after 
the end of the destination block. Note that the source and destination blocks do 
NOT have to be entirely on-chip or off-chip. However, BLKD cannot be used to 
transfer data from a memory-mapped register to any other location in data 
memory. 


The PC points to the instruction following BLKD after execution. Interrupts are 
inhibited during a BLKD operation used with RPT or RPTK. 


2 
Class XIII (4) 
Category A 


BLKD Block Move from Data Memory to Data Memory BLKD 


Example RPTK 
BLKD 


dmat 


Data 
Memory 
62464 


Data 
Memory 
62465 


Data 
Memory 
62466 


dma2 


Data 
Memory 
1030 


Data 
Memory 
1031 


Data 
Memory 
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>F400,*+ 


Before Instruction 


>+7T ESS 


>FFE6 


oO Bade 


Before Instruction 


~§: DEE 


79.3 45 


>253 1 


Data 
Memory 
62464 


Data 
Memory 
62465 


Data 
Memory 
62466 


Data 
Memory 
1030 


Data 
Memory 
1031 


Data 
Memory 
1032 


If current auxiliary register contains 1030. 


After Instruction 


>7F98 


>F FE6 


~F 6.2.2 


After Instruction 


>7F98 


dl et 


~¥G22 


BLKP Block Move from Program Memory to Data Memory BLKP 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Direct 


Indirect 


[<label>] BLKP <pma>,<dma> 
[<label>] BLKP <pma>,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < pma < 65535 
O < dma < 127 
O < next ARP < 7 


(PCY +2 PC 
(PFC) ~ MCS 
(pma) > PFC 


While (repeat counter) # 0: 
(pma, addressed by PFC) ~ dma, 
Modify AR(ARP) and ARP as specified, 
(PFC) + 1 ~ PEC, 
(repeat counter) - 1 > repeat counter. 


(pma, addressed by PFC) ~ dma 
Modify AR(ARP) and ARP as specified. 
(MCS) ~ PFC 


Pe eae ae a ee Be A ee eae 


1 1 1 1 1 1 0 O zs Data Memory Address 
Program Memory Address 


1 1 1 1 1 1 oem, 2, See Section 4.1 
Program Memory Address 


Consecutive memory words are moved from a source program memory block to 
a destination data memory block. The starting address (lowest) of the source 
block is defined by the second word of the instruction. The starting address of 
the destination block is defined by either the dma contained in the opcode (for 
direct addressing) or the current AR (for indirect addressing). In the indirect 
addressing mode, both the ARP and the current AR may be modified in the usual 
manner. In the direct addressing mode, dma is used as the destination address for 
the block move but is not modified by repeated executions of the instruction. 
Thus, the contents of memory at the dma address will be the same as the contents 
of memory at the last pma address in a repeat sequence. 


RPT or RPTK must be used with this instruction if more than one word is to be 
moved. The number of words to be moved is one greater than the number 
contained in the repeat counter RPTC at the beginning of the instruction. At the 
end of this instruction, the RPTC contains zero and, if using indirect addressing, 
AR(ARP) will be modified to contain the addr2ss after the end of the destination 
block. Note that source and destination blocks do NOT have to be entirely on-chip 
or off-chip. 


The PC points to the instruction following BLKP after execution. Interrupts are 
inhibited during a BLKP operation. 


lf the MP/MC pin is low at the time of execution of this instruction and the 
program memory address used is less than 4096, an on-chip ROM location will 
be read. 


Z 
Class XIV (4) 
Category A 


BLKP Block Move from Program Memory to Data Memory BLKP 


Example RPTK 2 
BLKP 65126, *+ If current auxiliary register contains 2048. 
pma 
Before Instruction After Instruction 
Program Program 
Memory >A089 Memory >A089 
65120 65120 
Program Program 
Memory 72 2 ok Memory 2 DCE 
65121 65121 
Program Program 
Memory >3 AQF Memory >3 AQF 
65122 65122 
dma 
Before Instruction After Instruction 
Data Data 
Memory >t234 Memory >A089Y9 
2048 
Data Data 
Memory 22005 Memory >20D CE 
2049 2049 
Data Data 
Memory >E9SC Memory >3 AQF 
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BLZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Branch if Accumulator Less Than Zero BLZ 


[<label>] BLZ <pma>[,{*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


O < pma < 65535 
O < next ARP < 7 


If (ACC) < 0: 
Then pma > PC; 
Eise. (PC) + 2-7 PC. 
Modify AR(ARP) and ARP as specified. 


16° 14° 43,12 37 0. 8 © 9x9 geen £2 elhCU2lLUE CU 


1 1 1 1 ‘oa, ee 1 1 See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are less than zero. Otherwise, control passes to the next instruction. Note 
that no AR or ARP modification occurs when nothing is specified in those fields 
Pma can be either a symbolic or a numeric address. 


2 
Class VII (3) 
Category X 


BLZ PRG481 481 is loaded into the program counter if the 
accumulator is less than zero. 
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BNC Branch on No Carry BNC 


Assembler Syntax [<label>] BNC <pma>[,{*|*+|*-|*0+|*0O-|*BRO+|*BRO-}[,<next ARP>]]. 


Operands O < pma < 65535 
O < next ARP < 7 


Execution If carry bit C = 0: 
Then pma ~ PC; 
Else (PC) + 2>% PC. 
Modify AR(ARP) and ARP as specified. 


Affected by C. 
Encoding oka ae Se as Se cs Bas COR ES Ame oe! oe ie ee a ee | 


oe Se 1 1 1 1 1 See Section 4.1 
Program Memory Address 


Description The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the carry bit C = 0. Other- 
wise, contro! passes to the next instruction. Note that no AR or ARP modification 
occurs when nothing is specified in those fields. Pma can be either a symbolic 
or a numeric address. 


Note that the carry bit C is affected by all add, subtract, and accumulate 
instructions as well as the ABS, LST1, NEG, RC, SC, rotate, and shift instructions. 
The carry bit is not affected by execution of the BC, BNC, or nonarithmetic 
instructions. 


Words yd 

Cycles Class VII (3) 

Repeatability Category X 

Example BNC PRG325 If the carry. bit C-= 0, 325 is -leaded into 


the program counter. Otherwise, the program 
counter is incremented by 2. 
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BNV 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Branch if No Overflow BNV 


[<label>] BNV <pma>[,{*|*+|*-|*0+]|*0-|*BRO+|*BRO-}[,<next ARP>]] 


O < pma < 65535 
O < next ARP < 7 


If overflow OV status bit = 0: 

Then pma > PC; 

Else (PC) + 2 ~ PC and O > OV. 
Modify AR(ARP) and ARP as specified. 


Affects OV; affected by OV. 
Ce Eee GRE Se ee ees oe a ce ce cee oe ee: ce a Per 2 


1 1 1 1 ane 1 1 1 See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program address if the OV (overflow flag) is clear. 
Otherwise, the OV is cleared, and control passes to the next instruction. Note that 
no AR or ARP modification occurs if nothing is specified in those fields. Pma 
can be either a symbolic or a numeric address. 


2 

Class VII (3) 

Category X 

BNV PRG315 315 is loaded into the program counter if 


the overflow flag is clear. OV is cleared. 
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BNZ Branch if Accumulator Not Equal to Zero BNZ 


Assembler Syntax = [<label>] BNZ <pma>[,{*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP>]]- 


Operands O < pma < 65535 
O < next ARP < 7 
Execution lf (ACC) # 0: 


Then pma > PC; 
Elise (PC)-+.2°* PC. 
Modify AR(ARP) and ARP as specified. 


Encoding 15.14 13-°912 ..47. 1047 Qi beBissg VOG;.<84 4 3 2 #1. OD 


1 1 1 1 Gar as 1 See Section 4.1 
Program Memory Address 


Description The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are not equal to zero. Otherwise, control passes to the next instruction. 
Note that no AR or ARP modification occurs if nothing is specified in those fields. 
Pma can be either a symbolic or a numeric address. 


Words 2 

Cycles Class VII (3) 

Repeatability Category X 

Example BNZ PRG320 320 is loaded into the program counter if 


the accumulator does not equal zero. 
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BV _ 


Branch on Overflow BV 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] BV <pma>[,{*|*+]|*-|*0+|*0-|"BRO+|*BRO-}[,<next ARP>]] 


0 < pma < 65535 
O < next ARP < 7 


If overflow (OV) status bit = 1: 
Then pma ~ PC and 0 > OV; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. 


Affects OV; affected by OV. 
+6 -~-14--1+3--12.—-71-—-10---9-- --8-- #--6--5- 4 3 2 1- .0 


1 1 1 1 o---o-—0-- 4-4 See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified, and the overflow 
flag is cleared. Control passes to the designated program memory address if the 
OV (overflow flag) is set. Otherwise, control passes to the next instruction. Note 
that no AR or ARP modification occurs if nothing is specified in those fields. Pma 
can be either a symbolic or a numeric address. 


2 

Class VII (3) 

Category X 

BV PRG610 If an overflow has occurred since the over- 


flow flag was last cleared, then 610 is 
loaded in the program counter. 
OV is cleared. 
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BZ Branch if Accumulator Equals Zero BZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] BZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


O < pma < 65535 
O < next ARP < 7 


If (ACC) = 0: 
Then pma > PC; 
Else (PU) £2 PC. 
Modify AR(ARP) and ARP as specified. 


1S 14.1342. 11 . 10/0 Be bebo? OSes FA. 4 3-2 1 


1 1 1 1 > iallaaes 1 _—— See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are equal to zero. Otherwise, control passes to the next instruction. Note 
that no AR or ARP modification occurs if nothing is specified in those fields. Pma 
can be either a symbolic or a numeric address. 


2 

Class VII (3) 

Category X 

BZ PRG102 102 is loaded into the program counter if 


the accumulator is equal to zero. 


CALA Call Subroutine Indirect CALA 


Assembler Syntax [<label>] CALA 


Operands None 


Execution (PS) + 7 305 
(ACC(15-0)) > PC 


Encoding oO: tm to 12-1) Te De ee eR SB OS OD 
1 saa: ama © is Ae Lae ee ae ee 0 


Description The current program counter is incremented and pushed onto the top of the stack. 
Then, the contents of the lower half of the accumulator are loaded into the PC. 
The carry bit is unaffected by this instruction. 


The CALA instruction is used to perform computed subroutine calls. 


Words 1 
Cycles Class VIII (3) 
Repeatability Category X 
Example CALA 
Before Instruction After Instruction 
ACC >8 3 ACC >8 3 
STACK STACK 
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ALL Call Subroutine CALL 


Assembler Syntax [<label>] CALL <pma>([,{*|*+]|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


Operands 0 < pma s 65535 
O < next ARP < 7 
Execution (PG) +-2 * TOS 
pma ~ PC 
Encoding [Ge 8: We at Aw. ee Ve es eee oe 2 Cg 


1 1 1 1 1 1 1 ee See Section 4.1 
Program Memory Address 


Description The current auxiliary register and ARP are modified as specified, and the PC 
(program counter) is incremented by two and pushed onto the top of the stack. 
The specified program memory address is then loaded into the PC. Note that no 
AR or ARP modification occurs if nothing is specified in those fields. Pma can 
be either a symbolic or a numeric address. 


Words 2 
Cycles Class VIII (3) 
Repeatability Category X 
Example CALL PRG109 
Before Instruction After Instruction 
STACK STACK 
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CMPL Complement Accumulator CMPL 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] CMPL 


None 


(PC) +1->PC 
(ACC) + ACC 


15.74 73 12 11 470 §..8 7. Gera 4 3 2 1. DO 
1 A rT s cae: ee ' sien siesta «Soe Se 1 1 


The contents of the accumulator are replaced with its logical inversion (one’s 
complement). 


1 
Class IV (1) 
Category C 
CMPL 
Before Instruction After Instruction 
ACC >F 7982513 ACC >0867DAEC 
; Cc 
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CMPR Compare Auxiliary Register with Auxiliary Register ARO CMPR 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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[<label>] CMPR <CM> 


0<CM<3 


(PC) + 1.7 FC 
Compare AR(ARP) to ARO, placing result in TC bit of status register ST1. 


Affects TC. 
Not affected by SXM; does not affect SXM. 


2p Mee Sake iy eae et ee ea eer ee, ice a ee eee pepe cee 


en ee Ae le eee : OO OTe | 


The CMPR instruction performs the following comparisons dependent on the 
value of CM: 


lf CM = 00, test if AR(ARP) = ARO 
If CM = 01, test if AR(ARP) < ARO 
lf CM = 10, test if AR(ARP) > ARO 
lf CM = 11, test if AR(ARP) « ARO 
lf the result of a test is true, a one is loaded into the TC status bit. Otherwise, 


TC is loaded with a zero. The auxiliary registers are treated as unsigned integers 
in the comparison. 


1 
Class IV (1) 
Category C 


CMPR 2 (ARP = 4) 


Before Instruction After Instruction 


ARO >FFFF ARO >FFFF 
AR4 S7FFF AR4 S7FFF 
TC TC 


CNFD Configure Block as Data Memory CNFD 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] CNFD 


None 


(PC) +1 > FC 
O ~ RAM configuration control (CNF) status bit 


Affects CNF. 


15 4 3 t2 741 80 °9 3:8 7 86 & 4 3 2 srtbocd 
1 1 Ow om 1 2 to. Oe A Sk 0 


On-chip RAM block 0 is configured as data memory. The block is mapped to 
locations 512 through 767 in data memory. This instruction is the complement 
of the CNFP instruction and sets the CNF bit in status register ST1 to a zero. 
CNF is also loaded by the CNFP and LST1 instructions. 


The next two instruction fetches immediately following a CNFD or CNFP 
instruction use the old value of CNF. 


1 
Class IV (1) 
Category C 


CNFD A zero is loaded into the CNF status bit, thus 
configuring block BO as data memory (see 
memory maps in Section 3.2). 
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CNFP Configure Block as Program Memory CNFEP 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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[<label>] CNEP 


None 


(PCy: 1* PC 
1 7 RAM configuration control (CNF) status bit 


Affects CNF. 


To 14 13.920 41 9 36 iF 6 Se 4 OG. 2. BCD 
ie a eee. ON ee Oe NA re eee a 


On-chip RAM block 0 is configured as program memory. The block is mapped 
to locations 65280 through 65535 in program memory space. This instruction 
is the complement of the CNFD instruction and sets the CNF bit in status register 
ST1 to a one. CNF is also loaded by the CNFD and LST1 instruction. 


Configuring this block as program memory allows the use of the program counter 
as an address generator to access data from on-chip RAM. Used in conjunction 
with the repeat instructions, this allows two data memory locations to be 
addressed simultaneously, one from the auxiliary registers and one from the 
program counter. Instructions that take advantage of this feature are the MAC, 
MACD, BLKD, and BLKP instructions. 


The next two instruction fetches immediately following a CNFD or CNFP 
instruction use the old value of CNF. 


1 
Class IV (1) 
Category C 


CNFP The CNF bit is set to a logic 1, thus config- 
uring block BO as program memory (see memory 
maps in Section 3.2) 


DINT Disable Interrupt DINT 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] DINT 


None 

(PCy.+ Tt > eo 

1 > interrupt mode (INTM) status bit 
Affects INTM. 


jf See oO a See - een eee ~ eee Selcewe. ras” Pacer come > 
| ae Se Dime: Pai, Bape Renee ate ce «csr. ae ee * RS ae 1 


The interrupt mode (INTM) status bit is set to logic 1. Maskable interrupts are 
disabled immediately after the DINT instruction executes. Note that the LST 
instruction does not affect INTM. 


The unmaskable interrupt, RS, is not disabled by this instruction, and the interrupt 
mask register (IMR) is unaffected. Interrupts are also disabled by a reset. 


1 
Class IV (1) 
Category C 


DINT Maskable interrupts are disabled, and INTM is 
set to.one, 
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DMOV Data Move in Data Memory DMOV 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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[<label>] DMOV <dma> 
[<label>] DMOV {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PG).+ + PC 
(dma) ~ dma + 1 


Affected by CNF. 
To ee 4 eee Se ee eA 


? a a ao 0 24 1 0 Data Memory Address 
Oi: $4 Ds toe: OF oohacdO hicks! See Section 4.1 


The contents of the specified data memory address are copied into the contents 
of the next higher address. DMOV works only within the on-chip data RAM 
blocks BO, B1, and B2. It works within block BO if it is configured as data memory, 
and the data move function is continuous across the boundaries of blocks BO and 
B1; ie., it works for locations 512 to 1023. The data move function cannot be 
used on external data memory. If used on external data memory or memory- 
mapped registers, DMOV will read the specified memory location but will perform 
no other operations. 


When data is copied from the addressed location to the next higher location, the 
contents of the addressed location remain unaltered. 


The data move function is useful in implementing the z71 delay encountered in 
digital signal processing. The DMOV function is included in the LTD and MACD 
instructions (see the LTD and MACD instructions for more information). 


1 
Class | (1) 
Category A 
DMOV DAT8 
or 
DMOV * If current auxiliary register contains 520. 
Before Instruction After Instruction 
Data Data 
Memory >43 Memory >43 
520 520 
Data Data 


Memory Memon 43 


EINT Enable Interrupt EINT 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] EINT 


None 


(PO) +.4.7-PC 
O > interrupt-mode (INTM) status bit 


Affects INTM. 


6 - O4° 13 $2 91. 9O..19 -26..c7- +6..c5 -4...3° 2 gates 
1 4 OFA 1 a et Oe a Poe Be 0 


The interrupt-mode flag (INTM) in the status register is cleared to logic 0. 
Maskable interrupts are enabled after the instruction following EINT executes. 
This allows an interrupt service routine to re-enable interrupts and execute a RET 
instruction before any other pending interrupts are processed. Note that the LST 
instruction does not affect INTM. (See the DINT instruction for further informa- 
tion.) 


1 
Class IV (1) 


Category C 


EINT Unmasked interrupts are enabled, and INTM is 
set to zero. 
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FORT Format Serial Port Registers FORT 


Assembler Syntax [<label>] FORT [<constant>] 


Operands Constant = 0 or 1 
Execution (PC) +.1 > PC 
Constant ~ format (FO) status bit 
Affects FO. 
Encoding 15. 04 NS 34.41 46. 19:58 oF 36-28) 4. 3. : 2.0chbod’® 


See Ss ae eas a ee ee ee ee ee a 


Description The format (FO) status bit is loaded by the instruction with the LSB specified in 
the instruction. The FO bit is used to control the formatting of the transmit and 
receive shift registers of the serial port. If FO = 0, the registers are configured to 
receive/transmit 16-bit words. If FO = 1, the registers are configured to 
receive/transmit 8-bit bytes. FO is set to zero on a reset. 


Words 1 

Cycles Class IV (1) 

Repeatability Category C 

Example FORT 1 The FO status bit is loaded with 1, making 


the bit length of the serial port 8 bits. 


4-60 


IDLE idle Until Interrupt IDLE 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] IDLE 


None 


PCY + TP 
O > interrupt mode (INTM) status bit 


Affects INTM. 


15 14.93 12 G4 -SAQi: BxhSs “ doetic sre 4-3 2 4 0 
1 y epee a: Caio ere: So ee es : Sia, 1 1 


The IDLE instruction forces the program being executed to wait until an interrupt 
or reset occurs. The PC is incremented only once, and the device remains in an 
idle state until interrupted. Note that INTM is set to zero in order for the maskable 
interrupts to be recognized. Execution of the IDLE instruction causes the device 
to enter the powerdown mode (see Section 3.4.6). 


1 
Class XV (3) 
Category X 


IDLE The processor idles until a reset or unmasked 
interrupt occurs. 
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IN Input Data from Port IN 


Assembler Syntax 
Direct Addressing: [<label>] IN <dma>,<PA> 
Indirect Addressing: [<label>] IN {*|*+|*-|*0+|*0-|*BRO+|*BRO-},<PA>[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP < 7 
O < port address PA < 15 


Execution (eC) +4 — PC 
Port address ~ address bus A3-A0 
0 ~ address bus A15-A4 
Data bus D15-D0O ~ dma 


Encoding Tae 2 ee ee be eee i ee oe ep ge ee 


Direct Port Data Memory Address 
Address 
Indirect Port 1 See Section 4.1 
Address 


Description The IN instruction reads a 16-bit value from one of the external I/O ports into the 
specified data memory location. The IS line goes low to indicate an !/O access, 
and the STRB, R/W, and READY timings are the same as for an external data 
memory read. 


Words 1 
Cycles Class IX (2) 
Repeatability Category A 
Example IN STAT,PA5 Read in word from peripheral on port 
address 5. Store in data memory 
location STAT. 
or 
LRLK LeD2v Load AR1 with decimal 520. 
LARP af Load ARP with decimal 520. 
IN *#— PAL, O Read in word from peripheral on port 


address 1. Store in data memory 
location 520. Decrement AR1 to 519. 
Load the ARP with 0. 
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LAC Load Accumulator with Shift LA 


Assembler Syntax 
Direct Addressing: [<label>] LAC <dma>,[<shift>] 
Indirect Addressing: [<label>] LAC {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<shift>[,<next ARP>]] 


Operands O < dma < 127 
O < next ARP < 7 
0 < shift < 15 (defaults to 0) 


Execution (PO) +.4 PO 
(dma) x 2shift + ACC 


If SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 


Then (dma) is not sign-extended. 
Affected by SXM. 
Encoding 1G 38 Te 3 a ee CB BR a a eee 


Direct | 0G Data Memory Address 
Indirect; 0 O 1 O ree. epee tree See Section 4.1 


Description The contents of the specified data memory address are left-shifted and loaded into 
the accumulator. During shifting, low-order bits are zero-filled. High-order bits 
are sign-extended if SXM = 1 and zeroed if SXM = 0. 


Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example LAC DAT6,4 (DP = 8) 
or 
LAC *,4 If current auxiliary register contains 1030. 
Before Instruction After Instruction 
Data Data 
Memory Memory 
1030 1030 
ACC ACC >10 
C C 


LACK Load Accumulator Immediate Short LACK 


Assembler Syntax [<label>] LACK <constant> 


Operands O < constant < 255 


Execution (Pt. tt * FC 
8-bit positive constant ~ ACC 


Not affected by SXM. 


Encoding 1p 14° 13-327 41-10 .. S28 = Fe ieee 4 SS 2 TG 
Es A 
Description The 8-bit constant is loaded into the accumulator right-justified. The upper 24 
bits of the accumulator are zeroed (i.e., sign extension is suppressed). 
Words 1 
Cycles Class IV (1) 
Repeatability Category X 
Example LACK >15 
Before Instruction After Instruction 
{, C 
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LACT Load Accumulator with Shift Specified by T Register LACT 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] LACT <dma> 
[<label>] LACT {*|*+]*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(PC) + 12> PO 
(dma) x 27 register(3-0) + ACC 


If SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 
Then (dma) is not sign-extended. 


Affected by SXM. 
Rl gh tO BR 2 Fics G 


oe 5 SRC + RS + ENDER 6 Secu 0 Data Memory Address 
Oi iy fg. NUR t gobrg ss pyle @: Pop See Section 4.1 


The LACT instruction loads the accumulator with a data memory value shifted left 
the number of places specified by the four LSBs of the T register. Using the T 
register’s contents as a shift code provides a variable shift mechanism. 


LACT may be used to denormalize a floating-point number if the actual exponent 
is placed in the four LSBs of the T register and the mantissa is referenced by the 
data memory address. Note that this method of denormalization can only be used 
when the magnitude of the exponent is four bits or less. 


1 
Class | (1) 
Category C 
LACT DAT1 (DP = 6) 
or 
LACT * If current auxiliary register contains 769. 
Before Instruction After Instruction 
Data Data 
Memory >1376 Memory of Oe 
769 769 
ACC >98F7EC83 ACC >13760 
ie S 
T >3014 T >3014 
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LALK Load Accumulator Long Immediate with Shift LALK 


Assembler Syntax [<label>] LALK <constant>[,<shift>] 


Operands 16-bit constant 
O < shift < 15 (defaults to 0) 


Execution (PLS 2 PC 
Constant x 28hift + ACC 


If SXM = 1: 

Then -32768 < constant < 32767. 
lf SXM = 0: 

Then O < constant < 65535. 


Affected by SXM. 
Encoding 18: 14. 13 -72241. 10.9 BAS ve Bea 4 


3 2 1 0 
ie: a Na ee wr ee ee 
16-Bit Constant 


Description The left-shifted 16-bit immediate value is loaded into the accumulator. The shifted 
16-bit constant is sign-extended if SXM = 1; otherwise, the high-order bits of 
the accumulator (past the shift) are set to zero. Note that the MSB of the accu- 
mulator can only be set if SXM = 1 and a negative number is loaded. The shift 
count is optional and defaults to zero. 


Words 2 
Cycles : Class V (2) 
Repeatability Category X 
Example 1 LALK >F794,8 (SXM=1) 
Before Instruction After Instruction 
ACC >12345678 ACC SFFF79400 
C C 
Example 2 LALK >F794,8 (SXM=0) 
Before Instruction After Instruction 
ACC >12345678 ACC >F79400 
os 
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LAR Load Auxiliary Register LAR 


Assembler Syntax 
Direct Addressing: [<label>] LAR <AR>,<dma> 
Indirect Addressing: [<label>] LAR <AR>,{*|*+|*-|*0+]|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < auxiliary register AR < 7 
O < next ARP < 7 


Execution (Po) + 7 FC 
(dma) > auxiliary register AR 


Encoding 1 918 7217. 2. 8 8 SF Se OS Re ee Se 


Direct - pS 1 0 Auxiliary Data Memory Address 
Register 

Indirect em 241 1 0 Auxiliary 1 See Section 4.1 
Register 


Description The contents of the specified data memory address are loaded into the designated 
auxiliary register. 


The LAR and SAR (store auxiliary register) instructions can be used to load and 
store the auxiliary registers during subroutine calls and interrupts. If an auxiliary 
register is not being used for indirect addressing, LAR and SAR enable the register 
to be used as an additional storage register, especially for swapping values 
between data memory locations without affecting the contents of the accumulator. 


Words 1 
Cycles Class Il (1) 
Repeatability Category C 
Example 1 LAR ARO ,DAT10 (DP = 4) 
Before Instruction After Instruction 
Data Data 
Memory >18 Memory >18 
522 522 
Example 2 LARP AR6 
LAR AR6,*- 
Before Instruction After Instruction 
Data Data 


Memory a 
617 


>3 2 


ye 
o 
SI 


LAR Load Auxiliary Register LAR 


Note: 


LAR, in the indirect addressing mode, ignores any AR modifications if the 


AR specified by the instruction is the same as that pointed to by the ARP. 
Therefore, in Example 2, AR6 is not decremented after the LAR instruction. 
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LARK Load Auxiliary Register Immediate Short LARK 


Assembler Syntax [<label>] LARK <AR>,<constant> 


Operands O < constant < 255 

O < auxiliary register AR < 7 
Execution (PC) + 1.7 PC 

8-bit constant ~ auxiliary register AR 
Encoding 15 14 13 #12 #«71:-40 GS aObrsAsheiocGan 4 «3.2. Yt CUO 

1 1 0 Oo QO Auxiliary 8-Bit Constant 
Register 

Description The 8-bit positive constant is loaded into the designated auxiliary register right- 


justified and zero-filled (i.e., sign-extension suppressed). 


LARK is useful for loading an initial loop counter value into an auxiliary register 
for use with the BANZ instruction. 


Words 1 

Cycles Class IV (1) 
Repeatability Category X 
Example LARK ARO,>15 


Before Instruction After Instruction 


ARO ARO 
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LARP Load Auxiliary Register Pointer LARP 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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[<label>] LARP <constant> 


O < constant < 7 


(PCi-+ Ee PC 
(ARP) ~ ARB 
Constant ~ ARP 


Affects ARP and ARB. 


To. 44 AS tees 10 Fe Ae Oe eee ek OED 
ee 2 ia Pg 2 eas: 1 1 eae: ee ARP 


The auxiliary register pointer is loaded with the contents of the three LSBs of the 
instruction (a 3-bit constant identifying the desired auxiliary register). The old 
ARP is copied to the ARB field of status register ST1. ARP can also be modified 
by the LST, LST1, and MAR instructions, as well as any instruction that is used 
in the indirect addressing mode. 


The LARP instruction is a subset of MAR; I.e., the opcode is the same as MAR 
in the indirect addressing mode. The following instruction has the same effect 
as LARP: 


MAR *,<constant> 


1 

Class IV (1) 

Category C 

LARP 1 Any succeeding instructions will use 
auxiliary register AR1 for indirect 
addressing. 


LDP Load Data Memory Page Pointer LDP 


Assembler Syntax 
Direct Addressing: [<label>] LDP <dma> 
Indirect Addressing: [<label>] LDP {*|*+|*-|*0+]*0-|"BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PC) +4 -+.PC 
Nine LSBs of (dma) ~ data page pointer register (DP) status bits 
Affects DP. 
Encoding mm 18 te 32 311...19. @ 8-7). ©. Ba 4A. 8 >. 2.1. 8 


Direct ee oe: 0) Data Memory Address 
Wawel |. Oy t.. Ol. ee coe See Section 4.1 


Description The nine LSBs of the contents of the addressed data memory location are loaded 
into the DP (data memory page pointer) register. The DP and 7-bit data memory 
address are concatenated to form 16-bit data memory addresses. The DP may 
also be loaded by the LST and LDPK instructions. 


Words 1 
Cycles Class Il (1) 
Repeatability Category C 
Example LDP DAT127 (DP = 511) 
or 
LDP * If current auxiliary register contains 65535. 
Before Instruction After Instruction 
Data Data 
Memory >F EDS Memory >F EOC 
65535 65535 


DP DP >DC 


LDPK Load Data Memory Page Pointer Immediate LDPK 


Assembler Syntax [<label>] LDPK <constant> 


Operands O < constant < 511 
Execution (Pos eS PG 
Constant ~ data memory page pointer (DP) status bits 
Affects DP. 
Encoding te 14 1S Beit Ae ee. cet eee Be ee FO 
ES fis Ot ree? | 
Description The DP (data memory page pointer) register is loaded with a 9-bit constant. The 


DP and 7-bit data memory address are concatenated to form 16-bit direct data 
memory addresses. DP > 8 specifies external data memory. DP = 4 through 7 
specifies on-chip RAM blocks BO or B1. Block B2 is located in the upper 32 
words of page 0. DP may also be loaded by the LST and LDP instructions. 


Words 1 

Cycles Class IV (1) 

Repeatability Category X 

Example LDPK 64 The data page pointer is set to 64. 
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LPH Load High P Register . LPH 


Assembler Syntax 
Direct Addressing: [<label>] LPH <dma> 
Indirect Addressing: [<label>] LPH {*|*+|*-|*0+|*0O-|"BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (Poy + 1 * 26 


(dma) > P register(31 -16) 
Encoding 1. Th 3 fH DD. ..8 5: ok SY 2. phoce@ 


S wf 
Direct oy .- 9 o: 1 < ieg : eke: 1 gs Data Memory Address 
ee Sk ek a Ok a ee ee eS See Section 4.1 


Description The P register high-order bits are loaded with the contents of data memory. The 
low-order P register bits are unaffected. 


The LPH instruction is particularly useful for restoring the high-order bits of the 
P register after subroutine calls or interrupts. 


Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example LPH DATO (DP = 4) 
or 
LPH * If current auxiliary register contains 512. 
Before Instruction After Instruction 
Data Data 
Memory >=F7 SC Memory ~F 7 9C 
512 512 
P >30079844 P >F79C9844 
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LRLK Load Auxiliary Register Long Immediate LRLK 


Assembler Syntax [<label>] LRLK <AR>,<constant> 


Operands O < auxiliary register < 7 
O < constant < 65535 
Execution (PC) + 2 PC 


Constant ~ AR 
Not affected by SXM; does not affect SXM. 
Encoding to. TH. hak ee. TS. a Sa ee Sa Se. 3 OS 2 othe 


t. 1} Oi ty oO: ORT TO. oy Pea®.. 0-0 0 
16-Bit Constant 


Description The 16-bit immediate value is loaded into the auxiliary register specified by the 
AR field. The specified constant must be an unsigned integer, and its value is 
not affected by SXM. 


Words ya 

Cycles Class V (2) 
Repeatability Category X 

Example LRLK AR3,>3080 


Before Instruction After Instruction 


AR3 >7F80 AR3 >3080 


LST Load Status Register STO LST 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


[<label>] LST <dma> 
[<label>] LST {*|*+|*-|*0+]|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC). + 1 * PC 
(dma) ~ status register STO 


Affects ARP, OV, OVM, and DP. 
Does not affect INTM or ARB. 
1 


14.13 12 11 = 1 a ae a. oe, ae ee Se Se 
0 


5 0 9 
Direct 0 7 7 uy  ~O).. Data Memory Address 
0 1 G-- --@-----§ 


1 
Indirect 0 1 See Section 4.1 


Description 


Words 
Cycles 
Repeatability 


Example 1 


| 


Status register STO is loaded with the addressed data memory value. Note that 
the INTM (interrupt mode) bit is unaffected by LST. ARB is also unaffected even 
though a new ARP is loaded. If a next ARP value is specified via the indirect 
addressing mode, the specified value is ignored. Instead, ARP is loaded with the 
value contained within the addressed data memory word. 


The LST instruction is used to load status register STO after interrupts and 
subroutine calls. The STO contains the status bits: OV (overflow flag) bit, OVM 
(overflow mode) bit, INTM (interrupt mode) bit, ARP (auxiliary register pointer), 
and DP (data memory page pointer). These bits were stored (by the SST 
instruction) in the data memory word as follows: 


15 14 t t2 11 10 9 8 7 6 5 4 3 2 1 0 
[ane povjovm[ 1 [wrm] SCP 


1 


Class Il (1) 
Category C 
LARP 0 
LST vi, 1 The data memory word addressed by the 


contents of auxiliary register ARO is 
loaded into status register STO, except 
for the INTM bit. Note that even 

though a next ARP value is specified, 
that value is ignored, and even though a 
new ARP is loaded, the old ARP is not 
loaded into ARB. 


LST Load Status Register STO 


Example 2 LST >60 (DP 


Before Instruction 


Data 
Memory 
96 
STO 


ST1 


Example 3 LARP AR7 (AR7 
LST *— 


Before Instruction 


AR7 


Data 
Memory 
1023 


STO 


ST1 


Example 4 LARP AR7 (AR7 
LST *=— 1 


Before Instruction 


AR7 


Data 
Memory 
1023 


STO 


ST1 
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= 0) 


>2404 


>6 E00 


>0580 


= >3FF) 


>3 FF 


>CEO6 


>FCO4 


>E780 


= >3FF) 


>3 FF 


>EEO4 


>EEOO 


>F 780 


Data 
Memory 
96 


STO 


ST1 


AR7 


Data 
Memory 
1023 


STO 


ST1 


AR7 


Data 
Memory 
1023 


STO 


ST1 


LS 


After Instruction 


>2404 


>2604 


>0580 


After Instruction 


>3FE 


>CEO6 


>C C06 


>E 780 


After Instruction 


>DR-E 


>EEO4 


>EEO4 


>F780 


snl 


LST1 Load Status Register ST1 LST1 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 


[<label>] LST1 <dma> 
[<label>] LST1 {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +1 > PC 


(dma) ~ status register ST1 
(ARB) ~ ARP 


Affects ARP, ARB, CNF, TC, SXM, C, HM, FSM, XF, FO, TXM, and PM. 
1 14- 44 F2 TEI see CUCU CU AS BS! 2 CT 


ea QO 1 CS a i} 6-.| Data Memory Address 


1 See Section 4.1 


Status register ST1 is loaded with the data memory value. The bits of the data 
memory value, which are loaded into ARB, are also loaded into ARP to facilitate 
context switching. Note that if a next ARP value is specified via the indirect 
addressing mode, the specified value is ignored. 


LST1 is used to load status bits after interrupts and subroutine calls. ST1 contains 
the status bits: ARB (auxiliary register pointer buffer), CNF (RAM configuration 
control) bit, TC (test/control) bit, SXM (sign-extension mode) bit, C (carry) bit, 
HM (hold mode) bit, FSM (frame synchronization mode) bit, XF (external flag) 
bit, FO (serial port format) bit, TXM (transmit mode) bit, and the PM (product 
register shift mode) bit. These bits are loaded into the status register from the 
data memory word as follows: 


18 <t4a T3. 12; -87 10 9 8 v/ 6 5 4 3 2 1 0 
[ARS [enF] Tc [exw] c [1 1 [HM|Fsm] xr] FO [iM] PM 
1 
Class Il (1) 

Category C 

LARP 3 

LST1 ie The data memory word addressed by the 
contents of auxiliary register AR3 
replaces the status bits of status 
register ST1l, and AR3 is decremented. 

LST1 >61 (DP = 0) 


Before Instruction After Instruction 


Data Data 
Memory >0580 Memory >0580 
97 97 


>0C00 
>0580 


STO >AC0O0 STO 
ST1 >0581 ST1 
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LST1 Load Status Register ST1 


Example 3 LARP  AR7 (AR7 = >3FE) 
LST1 *— 


Before Instruction 


ART 
Data 
Memory >4F90 
1022 
STO >FCO4 
ST1 >E780 
Example 4 LARP AR7 (AR7 = >3FE) 


LST1 a, d 


Before Instruction 


ART 
Data 

Memory >6190 
1022 
STO >FEO4 
ST1 >0593 
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AR7 


Data 
Memory 
1022 


STO 


ST1 


AR7 


Data 
Memory 
1022 


STO 


ST1 


LST1 


After Instruction 
>3 FD 


>4F90 


>5 C04 


>4F90 


After Instruction 
>3 FD 


>6190 


>7E0O04 


>6190 


LT Load T Register LT 


Assembler Syntax 
Direct Addressing: [<label>] LT <dma> 
Indirect Addressing: [<label>] LT {*|*+]|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP < 7 
Execution (PC}.+ 1.7 PC 


(dma) > T register 


Encoding 1, te a ae ee ee Oe OR ee Pe ee 


Direct 0 “03° 1 1 1 ee Data Memory Address 
iodvedtdisO =O} ON Oo 9 Ol tT See Section 4.1 


Description The T register is loaded with the contents of the specified data memory location. 
The LT instruction may be used to load the T register in preparation for multipli- 
cation. See also the LTA, LTD, LTP, LTS, MPY, MPYA, MPYK, MPYS, and MPYU 
instructions. 


Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example LT DAT24 (DP = 8) 
or 
LT * If current auxiliary register contains 1048. 
Before Instruction After Instruction 
Data Data 
Memory >6 2 Memory >6 2 
1048 1048 


T Li >6 2 


LTA Load T Register and Accumulate Previous Product LT 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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> 


[<label>] LTA <dma> 
[<label>] LTA {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +17 PC 


(dma) > T register 
(ACC) + (shifted P register) ~ ACC 


Affects C and OV; affected by OVM and PM. 
ce te eee ee ee ee OR ee oa Cg 


>: ies Se ee 1 1 1 0 1] 07 Data Memory Address 
soe. 5 Nay Wat of hasty ater wads See Section 4.1 


The T register is loaded with the contents of the specified data memory address. 
The contents of the product register, shifted as defined by the PM status bits, are 
added to the accumulator, with the result left in the accumulator. 


The function of the LTA instruction is included in the LTD instruction. 


1 


Class | (1) 

Category B 

LTA DAT36 (DP = 6, PM = 0) 

or 

LTA * If current auxiliary register contains 804. 


Before Instruction After Instruction 


Data Data 
804 804 
>6 2 


LTD _Load T Register, Accumulate Previous Product, and Move Data LTD 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] LTD <dma> 
[<label>] LTD {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC): +-1.2-PC 

(dma) ~ T register 

(dma) ~ dma + 1 

(ACC) + (shifted P register) ~ ACC 


Affects C and OV; affected by OVM and PM. 
ie 4a en ae A ee ee ee eS a oe 


a a ee Data Memory Address 


cn See Section 4.1 


The T register is loaded with the contents of the specified data memory address. 
The contents of the P register, shifted as defined by the PM status bits, are added 
to the accumulator, and the result is placed in the accumulator. The contents of 
the specified data memory address are also copied to the next higher data memory 
address. This instruction is valid for blocks B1 and B2, and is also valid for block 
BO if block BO is configured as data memory. The data move function is contin- 
uous across the boundary of blocks BO and B1, but cannot be used with external 
data memory or memory-mapped registers. This function is described under the 
instruction DMOV. Note that if used with external data memory, the function of 
LTD is identical to that of LTA. 


1 

Class | (1) 

Category B 

LTD DAT126 (DP = 7, PM = O) 

or 

LTD * If current auxiliary register contains 1022. 
Before Instruction After Instruction 

Data Data 


1022 


Data 


Memory Memory 62 
1023 1023 


ACC >5 ACC 
C 


o[¢e] 
BA 
& 
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LTP Load T Register and Store P Register in Accumulator LTP 


Assembler Syntax 
Direct Addressing: [<label>] LTP <dma> 
Indirect Addressing: [<label>] LTP {*|*+|*-|*0+]*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
0 < next ARP < 7 
Execution (PC) +17 PC 


(dma) > T register 
(shifted P register) ~ ACC 


Affected by PM. 
Encoding te 6. 44 ae Se a ee ee ee 


Direct a: 1 1 1 1 0 ae Data Memory Address 
indivetis 0529) 9 at. ad See Section 4.1 


Description The T register is loaded with the contents of the addressed data memory location, 
and the product register is stored in the accumulator. The shift at the output of 
the product register is controlled by the PM status bits. 


Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example LTP DAT36 (DP = 6, PM = 0) 
or 
LTP * If current auxiliary register contains 804. 
Before Instruction After Instruction 
Data Data 
Memory >G-2 Memory >6 2 
804 804 
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~” 


LTS Load T Register, Subtract Previous Product LT 


Assembler Syntax 
Direct Addressing: [<label>] LTS <dma> 
Indirect Addressing: [<label>] LTS {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP < 7 
Execution (Po) +1 > Pe 


(dma) ~ T register 
(ACC) - (shifted P register) ~ ACC 


Affects C and OV; affected by PM and OVM. 
Encoding to 36 4S SE ee ee ee, A eS ge Ls Si 


Direct SN 7: ee 1 Sinaia 14-07 | Data Memory Address 
indirect} 0 <1 0 °° 1 "1 6 ¥ sagas See Section 4.1 


Description The T register is loaded with the contents of the addressed data memory location. 
The contents of the product register, shifted as defined by the contents of the PM 
status bits, are subtracted from the accumulator. The result is left in the accu- 


mulator. 
Words 1 
Cycles Class | (1) 
Repeatability Category B 
Example LTS DAT36 (DP = 6, PM = 0) 
or 
LTS * If current auxiliary register contains 804. 
Before Instruction After Instruction 
Data Data 
804 804 


T T >6 2 
ACC acc fo] [>FFFFFFF6 
C 
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1c) 


MAC Multiply and Accumulate MAC 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 
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Direct 


Indirect 


[<label>] MAC <pma>,<dma> 
[<label>] MAC <pma>,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < pma < 65535 
0 < dma < 127 
0 < next ARP < 7 


(PO):+.2: PC 
(PFC) ~ MCS 
(pma) > PFC 


While (repeat counter) # 0: 
(ACC) + (shifted P register) ~ ACC, 
(dma) > T register, 
(dma) x (pma, addressed by PFC) > P register, 
Modify AR(ARP) and ARP as specified, 
(PEC) + 1°> PEC, 
(repeat counter) - 1 ~ repeat counter. 


(ACC) + (shifted P register) ~ ACC 

(dma) > T register 

(dma) x (pma, addressed by PFC) > P register 
Modify AR(ARP) and ARP as specified. 
(MCS) > PFC 


Affects C and OV; affected by OVM and PM. 


iC te ee et eee ae Se oe 


Sor bee ee ed Data Memory Address 
Program Memory Address 


eat Oo abe be See Section 4.1 
Program Memory Address 


The MAC instruction multiplies a data memory value (specified by dma) by a 
program memory value (specified by pma). It also adds the previous product, 
shifted as defined by the PM status bits, to the accumulator. 


The data and program memory locations may be any nonreserved, on-chip or 
off-chip memory locations. If the program memory is block BO of on-chip RAM, 
then the CNF bit must be set to one. Note that the upper eight bits of the program 
memory address should be set to >FF to address BO program RAM, and the upper 
six bits of dma should be set to 0 to address a location below 1024. When used 
in the direct addressing mode, the dma cannot be modified during repetition of 
the instruction. | 


When the MAC instruction is repeated, the program memory address contained 
in the PFC is incremented by one during its operation. This enables accessing a 
series of operands in memory. MAC is useful for long sum-of-products oper- 
ations, since MAC becomes a single-cycle instruction once the RPT pipeline is 
started. 


2 
Class VI (4) 
Category A 


Example 


MAC >FFOO,*+ Multiply/accumulate and increment AR1. 


?) 


MAC Multiply and Accumulate | MA 
SPM 3 Select a "shift-right-by-6" mode on PR output. 
CNFP Configure block BO as program memory (>FFXX). 
LARP 1 Use AR1 to address block Bl. 
LRLK 1,768 Point to lowest location in RAM block Bl. 
RPTR-- 255 Compute 256 sum-of-product operations. 


The following example shows register and memory contents before and after the 


third step repeat loop: 


Before Instruction 


PFC >FFO2 


Data 


770 


Program 
Memory 
65282 


ACC >723EC41 


ART 
RPT 
PFC 


Data 
Memory 
770 


Program 
Memory 
65282 


ACC 


After Instruction 


o1 


MACD Multiply and Accumulate with Data Move MACD 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 
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Direct 


[<label>] MACD <pma>,<dma> 
[<label>] MACD <pma>,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < pma < 65535 
0 < dma < 127 

O < next ARP < 7 
(PC) +2 =: Pe 
(PFC) ~ MCS 
(pma) ~ PFC 


While (repeat counter) 0: 
(ACC) + (shifted P register) ~ ACC, 
(dma) ~ T register, 
(dma) x (pma, addressed by PFC) > P register, 
(dma) ~ dma + 1, 
Modify AR(ARP) and ARP as specified, 
(PFC) + 1 PRG; 
(repeat counter) - 1 ~ repeat counter. 


(ACC) + (shifted P register) ~ ACC 

(dma) > T register 

(dma) x (pma, addressed by PFC) > P register 
(dma) ~ dma + 1 

Modify AR(ARP) and ARP as specified. 
(MGS) o* PFC 


Affects C and OV; affected by OVM and PM. 


16-74 4S) ee de oe le ee Bee, See ae Gee Cee *, 


7 
| oa 1 1 1 a a | Data Memory Address 
Program Memory Address 


Indirect i Se eae 1 1 O.< (0 See Section 4.1 
Program Memory Address 


The MACD instruction multiplies a data memory value (specified by dma) by a 
program memory value (specified by pma). It also adds the previous product, 
shifted as defined by the PM status bits, to the accumulator. 


The data and program memory locations may be any nonreserved, on-chip or 
off-chip memory locations. If MACD addresses one of the memory-mapped 
registers or external memory as a data memory location, the effect of the instruc- 
tion will be that of a MAC instruction (see the DMOV instruction description). 


If the program memory is block BO of on-chip RAM, then the CNF must be set 
to one. Note that the upper eight bits of the program memory address should 
be set to >FF to address BO program RAM, and the upper six bits of the effective 
16-bit dma should be set to O to address a location below 1024. When used in 
the direct addressing mode, the dma cannot be modified during repetition of the 
instruction. 


MACD functions in the same manner as MAC, with the addition of data move for 
block BO, B1, or B2. Otherwise, the effects are the same as for MAC. This feature 
makes MACD useful for applications such as convolution and transversal filtering. 


and Accumulate with Data Move 


MACD Multiply MACD 


Words 
Cycles 
Repeatability 


Example 


When the MACD instruction is repeated, the program memory address contained 
in the PFC is incremented by one during its operation. This enables accessing a 
series of operands in memory. When used with RPT or RPTK, MACD becomes 


a single-cycle instruction once the RPT pipeline is started. 


2 
Class VI 
Category 


SPM 

SOVM 
CNF'P 
LARP 
LRLK 
RPTK 
MACD 


(4) 
A 


0 


io 
31,1023 
Phe be 


Select no shift mode on PR output. 


Set overflow mode. 


Configure block BO as program memory (>FFXX). 


Use AR3 to address block Bl. 


Point to highest location in RAM block Bl. 

Compute 1 sample of a length-256 convolution. 
>FFOO,*- Multiply/accumulate, shift data word in block 
Bl, and decrement AR3. 


The following example shows register and memory contents before and after the 
third step repeat loop: 


ARI 
RPT 
PFC 


Data 
Memory 
1021 


Data 
Memory 
1022 


Program 
Memory 
65282 


ACC 


Note: 


OLX 


Before Instruction 
~>3 FD 


V 
7 
O 


V V V 
NO No a1 
Ww wo O 


>F FOZ 


V 
NO 
1) 


aw ie 


>FAAA 


>458972 


>723EC41 


o[e] 


AR1 


RPT 


PFC 


Data 
Memory 
1021 


Data 
Memory 
1022 


Program 
Memory 
65282 


After Instruction 
>SFC 


>F F023 


>FAAA 


>FFFF453E 


>7/69 7563 


The data move function for MACD can only occur within on-chip data RAM 
blocks BO, B1, and B2. 
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MAR Modify Auxiliary Register MA 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 


Example 3 


4-88 


=) 


[<label>] MAR <dma> 
[<label>] MAR {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 


O < next ARP < 7 


(PC) +17PC 


Modifies ARP, AR(ARP) as specified by the indirect 
addressing field (acts as a NOP in direct addressing). 


15° 14. 13 
2 aera ese), 
Sass ee. 


tees ky <0 56. -f- 36 =e a 3: ULC ECD 


1 est 4 0 1] 0— Data Memory Address 
1 Sec 4 See Section 4.1 


The MAR instruction acts as a no-operation instruction in the direct addressing 
mode. In the indirect addressing mode, the auxiliary registers and the ARP are 
modified; however, no use is made of the memory being referenced. MAR is used 
only to modify the auxiliary registers or the ARP. The old ARP is copied to the 
ARB field of status register ST1. Note that any operation that MAR performs can 
also be performed with any instruction that supports indirect addressing. ARP 
may also be loaded by an LST instruction. 


In the direct addressing mode, MAR is a NOP. Also, the instruction LARP is a 
subset of MAR (i.e., MAR *,4 performs the same function as LARP 4). 


1 
Class IV (1) 
Category C 


Load the ARP with 1. 


Before Instruction After Instruction 


Decrement current auxiliary register (in this 
case, AR1) 


Before Instruction After Instruction 


Increment current auxiliary register (AR1) and 
load ARP with 5. 


Before Instruction After Instruction 


MPY Multiply MPY 


Assembler Syntax 
Direct Addressing: [<label>] MPY <dma> 
Indirect Addressing: [<label>] MPY {*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (Po) + 7.7 PC 


(T register) x (dma) > P register 


Encoding 8. 38.32. 32. 143-780: 9. 8 4 GS eM SOR AD 


Direct °F 1 1 legis: Scale 3 Data Memory Address 
indvects;cO O07 Alot 1 90 tO 30} 4 | See Section 4.1 


Description The contents of the T register are multiplied by the contents of the addressed data 
memory location. The result is placed in the P register. 
Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example MPY DAT13 (DP = 8) 
or 
MPY * If current auxiliary register contains 1037. 
Before Instruction After Instruction 
Data Data 
Memory Memory 
1037 1037 
T ina fe 
>36 , >2A 


‘ 
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MPYA Multiply and Accumulate Previous Product MPYA 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


4-90 


[<label>] MPYA <dma> 
[<label>] MPYA {*|*+|*-|*0+]|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PO) +1 PC 

(ACC) + (shifted P register) ~ ACC 

(T register) x (dma) > P register 

Affects C and OV; affected by OVM and PM. 


Pe. tare i tee ee tee ae ee OB ge 


Ob, 14 0F 01 Go Tole Data Memory Address 
QO 20d5.4 0 See Section 4.1 


The contents of the T register are multiplied by the contents of the addressed data 
memory location. The result is placed in the P register. The previous product, 
shifted as defined by the PM status bits, is also added to the accumulator. 


1 


Class | (1) 
Category A 
MPYA DAT13 (DP = 6, PM = 0) 
or 
MPYA * If current auxiliary register contains 781. 
Before Instruction After Instruction 
Data Data 
memory = [ >?) — Memory 
781 781 
T T 
ACC >5 4 acc —_[o| >B A 
& C 


MPYK Multiply Immediate MPYK 


Assembler Syntax [<label>] MPYK <constant> 


Operands -4096 < constant < 4095 
-212 < constant < 212 - 1 
Execution (PC) 7 > FC 


(T register) x constant ~ P register 


Not affected by SXM. 


Encoding pce gies ie ne i | i i a ae a” a 0 
1 ie 13-Bit Constant 
Description The contents of the T register are multiplied by the signed, 13-bit constant. The 


result is loaded into the P register. The immediate field is right-justified and 
sign-extended before multiplication, regardless of SXM. 


Words 1 

Cycles Class IV (1) 
Repeatability Category X 
Example MPYK -9 


Before Instruction After Instruction 


T T 
P >2A 4 “6 Ue OS 
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MPYS Multiply and Subtract Previous Product MPYS 


Assembler Syntax 
Direct Addressing: [<label>] MPYS <dma> 
Indirect Addressing: [<label>] MPYS {*|*+]|*-|*0+]|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PO) + TFC 


(ACC) - (shifted P register) ~ ACC 
(T register) x (dma) ~ P register 


Affects C and OV; affected by OVM and PM. 
Encoding ch Siege yale Sore: SRS SG AY ee See Se Se ears eee Se. Saree cmee ee 6, 


Direct ¢ et eae 1 1 O 2+] 1 8. Data Memory Address 
iuiest 2 Gt ee | ee See Section 4.1 


Description The contents of the T register are multiplied by the contents of the addressed data 
memory location. The result is placed in the P register. The previous product, 
shifted as defined by the PM status bits, is also subtracted from the accumulator. 


Words 1 
Cycles Class | (1) 
Repeatability Category A 
Example MPYS DAT13 (DP = 6, PM = 0) 
or 
MPYS * If current auxiliary register contains 781. 
Before Instruction After Instruction 
Data Data 
781 781 
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MPYU Multiply Unsigned MPYU 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] MPYU <dma> 
[<label>] MPYU {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 

O < next ARP < 7 

(PG) +31 + FC 

Unsigned (T register) x unsigned (dma) ~ P register 


+O Ae: fe ae F107 8 8 ok eB re ee 2 TD 


te Was - BS ce Ge Re 2 Data Memory Address 
1. Solsine@ si cOrnstheas loisidousha oft See Section 4.1 


The unsigned contents of the T register are multiplied by the unsigned contents 
of the addressed data memory location. The result is placed in the P register. Note 
that the multiplier acts as a 17 x 17-bit signed multiplier for this instruction, with 
the MSB of both operands forced to zero. 


The shifter at the output of the P register will always. invoke sign-extension on 
the P register when PM = 3 (right-shift by 6 mode). Therefore, this shift mode 
should not be used if unsigned products are desired. 


The MPYU instruction is particularly useful for computing multiple-precision 
products, such as when multiplying two 32-bit numbers to yield a 64-bit product. 
1 

Class | (1) 

Category C 

MPYU DAT16 (DP = 4) 


MPYU * If current auxiliary register contains 528. 


Before Instruction After Instruction 
Data 


Memory >P PEF Memory >FFFF 
528 528 


NEG Negate Accumulator NEG 


Assembler Syntax [<label>] NEG 


Operands None 


Execution CPGy +2 PC 
(ACC) x -1 7 ACC 


Affects C and OV; affected by OVM. 


Encoding (Go eee? ee Pe Se | es RL. ee Sees: aes ie Se Se a 2, 
1 17 @ Gs 1 Be ee Oe eee ap Apes a, 1 


Description The contents of the accumulator are replaced with its arithmetic complement 
(two’s complement). The OV bit is set when taking the NEG of >80000000. If 
OVM = 1, the accumulator contents are replaced with >7FFFFFFF. If OVM = 
0, the result is >80000000. The carry bit C is reset to zero by this instruction for 
all nonzero values of the accumulator, and set to one if the accumulator equals 


zero. 
Words 1 
Cycles Class IV (1) 
Repeatability Category C 
Example NEG 
Before Instruction After Instruction 
ACC >FFFFF228 acc [o| 
i C 
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NOP No Operation NOP 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] NOP 


None 
(PG) +1 ~PC 


16.74.13 T2. 71-40 8 $8 2. Avaes 4. $$ 25.1.2 
, £ 8 +. @ st Se Peto oe ee. 8 


No operation is performed. The NOP instruction affects only the PC. NOP func- 
tions in the same manner as the MAR instruction in the direct addressing mode; 
NOP has the same opcode as MAR in the direct addressing mode with dma = 
0. 


The NOP instruction is useful as a pad or temporary instruction during program 
development. 


1 
Class IV (1) 
Category B 


NOP 
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NORM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 1 
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Normalize Contents of Accumulator NORM 


[<label>] NORM {*|*+|*-|*0+|*0-|*BRO+|*BRO-} 
None 
LPG) +.4..7%- PC 


If (ACC) = 0: 
Then TC > 1; 
Else, if (ACC(31)).XOR.(ACC(30)) = 0: 
Then TC > O, 
(ACC) x 2 7 ACC, 
Modify AR(ARP) as specified; 
Else TC > 1. 


Affects TC; affected by TC. 


1S ike Te ae OT Oe ee ee a a EE 


1 Ve oe 1 ; eae * ee Modify 0 vO det 0 
AR 


The NORM instruction is provided for normalizing a signed number that is 
contained in the accumulator. Normalizing a fixed-point number separates it into 
a mantissa and an exponent. To do this, the magnitude of a sign-extended number 
must be found. ACC bit 31 is exclusive-ORed with ACC bit 30 to determine if 
bit 30 is part of the magnitude or part of the sign extension. If they are the same, 
they are both sign bits, and the accumulator is left-shifted to eliminate the extra 
sign bit. 


The AR(ARP) is modified as specified to generate the magnitude of the exponent. 
It is assumed that AR(ARP) is initialized before the normalization begins. The 
default modification of the AR(ARP) is an increment, making it compatible with 
the TMS32020. 


Multiple executions of the NORM instruction may be required to completely 
normalize a 32-bit number in the accumulator. Although using NORM with RPT 
or RPTK does not cause execution of NORM to “fall out” of the repeat loop 
automatically when the normalization is complete, no operation is performed for 
the remainder of the repeat loop. Note that NORM functions on both positive 
and negative two’s-complement numbers. 


1 
Class IV (1) 
Category A 


31-Bit Normalization: 


LARP 1 Use AR1 for exponent storage. 
LARK 230 Clear out exponent counter. 
LOOP NORM * + One bit is normalized. 
BBZ LOOP If TC = 0, magnitude is not found yet. 


NORM Normalize Contents of Accumulator NORM 


Example 2 15-Bit Normalization: 
LARP 1 Use AR1 to store the exponent. 
LARK y Ses 8 Initialize exponent counter. 
RPTK 14 15-bit normalization is specified 


(yielding a 4-bit exponent and a 16-bit 
mantissa). 

NORM Rm NORM automatically stops shifting 
when the first significant magnitude 
bit is found, performing NOPs for the 
remainder of the repeat loop. 


The first method is used to normalize a 32-bit number and yields a 5-bit exponent 
magnitude. The second method is used to normalize a 16-bit number and yields 
a 4-bit exponent magnitude. If it is known that the number requires only a small 
amount of normalization, the first method may be preferable to the second. This 
results because Example 1 runs only until normalization is complete. Example 2 
always executes all 15 cycles of the repeat loop. Specifically, Example 1 is more 
efficient if the number requires five or less shifts. If the number requires six or 
more shifts, Example 2 is more efficient. 


Note: 


Source code compatibility with the TMS32020 allows the NORM instruction 
to be used without a specified operand. In that case, any comments on the 
same line as the instruction will be interpreted as the operand. If the first 
character is an asterisk (*), then the instruction will be assembled as 


NORM * with no auxiliary register modification taking place upon execution. 
The user is therefore advised to replace the NORM instructions with 
NORM *+ when the default modification of increment is desired. 


The resulting value in the auxiliary register will not be the real exponent of the 
number for all modification options. However, it can always be used to obtain 
the exponent. 
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OR 


OR with Accumulator OR 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


[<label>] OR <dma> 
[<label>] OR {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(Pi). +t asPG 

(ACC(15-0)) .OR.dma ~ ACC(15-0) 
(ACC(31-16)) ~ ACC(31-16) 

Not affected by SXM. 


kc gmail MSE Wa As «pees 3S ogi Teal as - Eine’ flack «te ier a: as i 


Direct 4 OD. sete «3 1 Ri arit sit Data Memory Address 


Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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) 1 yc.) 1 1 0 BA 4 See Section 4.1 


The low-order bits of the accumulator are ORed with the contents of the 
addressed data memory location. The high-order bits of the accumulator are ORed 
with all zeroes. Therefore, the upper half of the accumulator is unaffected by this 
instruction. 


1 
Class | (1) 
Category B 
OR DATS8 (DP = 8) 
or 
OR * Where current auxiliary register contains 1032. 
Before Instruction After Instruction 
Data Data 
Memory >FO0OO Memory >FOOO 
1032 1032 
ACC >00100002 ACC >0010F002 
C G 


ORK OR Immediate with Accumulator with Shift ORK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] ORK <constant>([,<shift>] 


16-bit constant 
0 < shift < 15 (defaults to 0) 


(PC) +2 PC 


(ACC(30-0)).OR.[constant x 2Shift] + ACC(30-0) 
(ACC(31)) 7 ACC(31) 


Not affected by SXM. 
15. 14 13 12. 11~ 1060-9: Gué deh G farsi 4. 3 «2 #+T.- 0 


ene en ee MR SE ae Se ee ee ee 
16-Bit Constant 


The left-shifted 16-bit immediate constant is ORed with the accumulator. The 
result is left in the accumulator. Low-order bits below and high-order bits above 
the shifted value are treated as zeroes. The corresponding bits of the accumulator 
are unaffected. Note that the most-significant bit of the accumulator is not 
affected, regardless of the shift code value. 


2 
Class V (2) 
Category X 
ORK >FFFF,8 
Before Instruction After Instruction 
ACC >12345678 ACC >12FERE78 
c 5 
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her 


UT ut Data to Port U 


Assembler Syntax 
Direct Addressing: [<label>] OUT <dma>,<PA> 
Indirect Addressing: [<label>] OUT {*|*+|*-|*0+|*0-|“BRO+|*BRO-},<PA>[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP <s 7 
O < port address PA < 15 


Execution (PC) 4.720 
Port address PA ~ address bus A3-A0O 
0 ~ address bus A15-A4 
(dma) ~ data bus D15-D0 


Encoding 15-14. -13.142-.11- 10....-0— -8--- 7-5. 6-4 3 .2 1 OQ 


Direct Port Data Memory Address 
Address 
Port See Section 4.1 
Address 


Description The OUT instruction writes a 16-bit value from a data memory location to the 
specified |/O port. The IS line goes low to indicate an I/O access, and the 
STRB, R/W, and READY timings are the same as for an external data memory write. 
OUT is a single-cycle instruction when in the PI/DI memory configuration (see 


Indirect 


| Appendix E). 
Words 1 
Cycles Class X (1) 
Repeatability Category A 
Example OUT >78,7 (DP = 4) Output data word stored in data 


memory location >78 to peripheral on 
port address 7. 

OUT *.>F Output data word referenced by current 
auxiliary register to peripheral on port 
address >F. 
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PAC Load Accumulator with P Register PAC 


Assembler Syntax [<label>] PAC 


Operands None 


Execution (PC) + 17 PC 
(shifted P register) ~ ACC 


Affected by PM. 


Encoding 1S 74° 43: 42. 1 0. 29. 22 ct. 36 tb. 4 dC U68.lCU2 artic 
1. OF te, TO FC ar Pe 2 ee tee td... OS dG 

Description The contents of the P register are loaded into the accumulator, shifted as specified 

by the PM status bits. 

Words 1 

Cycles Class IV (1) 

Repeatability Category C 

Example PAC (PM = 0) 


Before Instruction After Instruction 


acc 23] ace 
C 


C 
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POP Pop Top of Stack to Low Accumulator POP 


Assembler Syntax [<label>] POP 


Operands None 


Execution (POY +. F-7.PC 
(TOS) ~ ACC(15-0) 
0 ~ ACC(31-16) 
Pop stack one level. 


Encoding To We FS. Be) Ae OIE ee ee oo BAS 2 BED 
a OR tee a eee eae ee ee EE SQ 


Description | The contents of the top of the stack (TOS) are copied to the low accumulator, 
and the stack popped after the contents are copied. The upper half of the accu- 
mulator is set to all zeros. The hardware stack is a last-in, first-out stack with eight 
locations. Any time a pop occurs, every stack value is copied to the next higher 
stack location, and the top value is removed from the stack. After a pop, the 
bottom two stack words will have the same value. Because each stack value is 
copied, if more than seven pops (due to POP, POPD, or RET instructions) occur 
before any pushes occur, all levels of the stack contain the same value. No 
provision exists to check stack underflow. 


Words 1 
Cycles Class IV (1) 
Repeatability Category C 
Example POP 
Before Instruction After Instruction 
c c 
STACK STACK 
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Assembler Syntax 
Direct Addressing: [<label>] POPD <dma> 
Indirect Addressing: [<label>] POPD {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
0 < next ARP < 7 
Execution (PG) + TPC 
(TOS) > dma 


POP stack one level. 


Encoding 15: 44: 13 42. 44. 40°..9 GS 26..°.@: - 3. Zine 0 


$97 
Dimet00: 4) Got 41 Oo oT Ope) Data Memory Address 
iielimce | O° 21) A ot ot 60 et FO] at See Section 4.1 


Description The value from the top of the stack is transferred into the data memory location 
specified by the instruction. The values are also popped in the lower seven 
locations of the stack. The hardware stack is described in the previous instruction 
POP. The lowest stack location remains unaffected. No provision exists to check 
stack underflow. 


Words 1 
Cycles Class Ill (1) 
Repeatability Category A 
Example POPD DAT100 (DP = 8) 
or 
POPD * If current auxiliary register contains 1124. 
Before Instruction After Instruction 
Data Data 
Memory > 5 Memory >92 
1124 1124 
Stack Stack 
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PSHD Push Data Memory Value onto Stack PSHD 


Assembler Syntax 
Direct Addressing: [<label>] PSHD <dma> 
Indirect Addressing: [<label>] PSHD {*|*+|*-|*0+|*0-|"BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
QO < next ARP < 7 
Execution (dma) ~ TOS 
(PC) +1 PC 


Push all stack locations down one level. 


Encoding 1D. 44 3: 42. 41. FO 9 38. -7 «<6 +h 4 . 3... 2 Str 26 


Direct | ee OSs] oe ~T i Seem 6 Data Memory Address 
nmniett: 0 15-01 Pe to: 4 oe te Pa See Section 4.1 


Description The value from the data memory location specified by the instruction is transferred 
to the top of the stack. The values are also pushed down in the lower seven 
locations of the stack, as described in the next instruction PUSH. The lowest stack 
location is lost. | 


Words 1 
Cycles Class | (1) 
Repeatability Category A 
Example PSHD DAT127 (DP = 3) 
or 
PSHD * If current auxiliary register contains 511. 
Before Instruction After Instruction 
Data Data 
Memory >6 5 Memory | >65 
511 511 
Stack Stack 
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PUSH Push Low Accumulator onto Stack PUSH 


Assembler Syntax [<label>] PUSH 


Operands None 


Execution (PC): *.T “FC 
Push all stack locations down one level. 
(ACC(15-0)) > TOS 


Encoding Pee Dee es a ee A Oe 
2 Raita, cpm: « Setees < Sate, Pesala: GIN Rete i Boi: = SOR «eis « I, SRI Sain Min «ge tect 


Description The contents of the lower half of the accumulator are copied onto the top of the 
hardware stack. The stack is pushed down before the accumulator value is copied. 
The hardware stack is a last-in, first-out stack with eight locations. If more than 
eight pushes (due to CALA, CALL, PSHD, PUSH, or TRAP instructions) occur 
before a pop, the first data values written will be lost with each succeeding push. 


Words 1 
Cycles Class IV (1) 
Repeatability Category C 
Example PUSH 
Before Instruction After Instruction 
ACC ACC 
STACK STACK 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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Reset Carry Bit 


[<label>] RC 
None 
(PC) +:1-- PC 


0 > carry bit C in status register ST1 
Affects C. 


ia ae ke | eee ee eae. eae oe ee Ue me 
Pa ae ee oe ee ee Ok a Ry 


The carry bit C in status register ST1 is reset to logic zero. The carry bit may also 
be loaded directly by the LST1 and SC instructions. 


1 
Class IV (1) 
Category C 


RC The carry bit C is reset to logic zero. 


RET Return from Subroutine RET 


Assembler Syntax [<label>] RET 


Operands None 
Execution (TOS): PC 
Pop stack one level. 
Encoding 16°. 78. 48. E294. oA oe 8. ease 4 SB 2D 
1 1 fe -a  " 1 1 6 ake * aay S Tene | ae 9 1 0 
Description The contents of the top stack register are copied into the program counter. The 
stack is then popped one level. RET is used with CALA and CALL for subroutines. 
Words 1 
Cycles Class VIII (3) 
Repeatability Category X 
Example RET 
Before Instruction After Instruction 


V 
V 


STACK STACK 


V 
Vv 


VV VV 
: its V 


V 


4 
5 
2 
>3 
4 
6 
6 
6 


mmm on— oo 


37 
45 
75 
21 
>3 F 
45 
6E 
6E 


V 
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RFESM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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Reset Serial Port Fram nc M RFSM 


[<label>] RFSM 


None 


(PC) +1 PC 
0 ~ FSM status bit in status register ST1 


Affects FSM. 


16.-—14..-43-- 1. 2— 41-— 10.9 >-- 8-7. 8-8 4 3 2 1 +0 
Ri Deiat Dai Gita: thy tess ees Ot Gace, Sy 1 0 deiedianed 


The RFSM status bit resets the FSM status bit to logic zero. In this mode, external 
FSR pulses are not required to initiate the receive operation for each word 
received, but rather only one FSR pulse is required to initiate a “continuous mode” 
of operation. The same holds true for FSX when TXM = 0. After the first FSR/FSX 
pulse, these inputs are then in a “don’t care” state. If TXM = 1, FSX is pulsed the 
first time DXR is loaded, but remains low thereafter. See Section 3.7 for further 
details on the operation of the serial port. FSM may also be loaded by the LST1 
and SFSM instructions. 


1 
Class IV (1) 
Category C 


RFSM FSM is reset, putting the serial port 
in a mode of operation where frame 
synchronization pulses are not required. 
This allows a continuous bit stream to 
be transmitted or received without FSX/FSR 
pulses every 8/16 bits. 


RHM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Reset Hold Mode RHM 


[<label>] RHM 


None 


(PC) +17 PC 
O ~ HM status bit in status register ST1 


Affects HM. 


Oo. 14 13 12. 11 4. SB ioe 4 8 2s ae G 
So ee eS ROC ob Re a a ee oe 


The RHM instruction resets the HM status bit to logic zero. In this mode, the 
TMS320C25 is not halted during the assertion of HOLD when executing from 
on-chip program memory (either RAM or ROM), but instead places its external 
buses in the high-impedance state and continues execution until an external 
access must be made. External access can mean (in addition to the normal 
connotation) the following conditions: 


MP/MC CNF PC 
0 0 PC 4096 
0 1 4096 < PC < 65279 
1 0 Any PC value (normal TMS32020-type 
hold mode) 
1 1 PC < 65279 


HM can also be loaded by the LST1 and SHM instructions. 
1 


Class IV (1) 

Category C 

RHM HM is reset, implementing the new 
TMS320C25 hold mode for on-chip program 
execution. 
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ROL 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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Rotate A mulator Left ROL 


[<label>] ROL 


None 


(PC) +1 PC 
(ACC(31)) 7 C 
(ACC(30-0)) ~ ACC(31-1) 
(C, before ROL) ~ ACC(Q) 


Affects C. 

Not affected by SXM. 

cf Ra a SR ee gee ee ey eee ee 1 0 
1 1 O>° +O pa 1 1 O.= coger 1 G4 0 0 

The ROL instruction rotates the accumulator left one bit. The MSB is shifted into 


the carry bit, and the value of the carry bit from before the execution of the 
instruction is shifted into the LSB. 


1 


Class IV (1) 
Category A 
ROL 
Before Instruction After Instruction 
ACC [1] >B0001234 ACC [1] >60002469 
C C 


ROR 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Rotate A mulator Right ROR 


[<label>] ROR 


None 


(PC) +17 PC 
(ACC(0)) > C 
(ACC(31-1)) ~ ACC(30-0) 
(C, before ROR) ~ ACC(31) 


Affects C. 

Not affected by SXM. 

io eh te ee Te. Se. BP Be BR OR CR ED 
Heisei) tay ee tasks UC) dtu) are sieweniaeuA me te Te eee OF 
The ROR instruction rotates the accumulator right one bit. The LSB is shifted into 


the carry bit, and the value of the carry bit from before the execution of the 
instruction is shifted into the MSB. 


1 


Class IV (1) 
Category A 
ROR 
Before Instruction After Instruction 
acc [o] [>B0001234 acc [o] [>5800091A 
C Ber 
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ROVM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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Reset Overflow Mode ROVM 


[<label>] ROVM 


None 


(PC) 1. PC 
0 ~ OVM status bit in status register STO 


Affects OVM 


19.38) 13 3244 40 88: os oes TD 
5 eas Dame Res: ce Bae Pace ae OME pees ee a A 0 


The OVM status bit is reset to logic zero, which disables the overflow mode. If 
an overflow occurs with OVM reset, the OV (overflow flag) is set, and the over- 
flowed result is placed in the accumulator. OVM may also be loaded by the LST 
and SOVM instructions. 


1 
Class IV (1) 
Category C 


ROVM The overflow mode bit OVM is reset, 
disabling the overflow mode on any 
subsequent arithmetic operations. 


RPT Repeat Instruction as ecified by Data Memory Value RPT 


Assembler Syntax 
Direct Addressing: [<label>] RPT <dma> 
Indirect Addressing: [<label>] RPT {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP < 7 
Execution (PE) +a. = PC 


(dma(7-0)) ~ RPTC 
Encoding ae Oo ae ee eee | a: ee a re. oe a ee cee me 


Direct 3 ae 2 iisad i 44-0. Data Memory Address 
indwect 1. 0 54 rth OA. Wn afk aa th ey See Section 4.1 


Description The eight LSBs of the addressed data memory value are loaded into the repeat 
counter (RPTC). This causes the following instruction to be executed one time 
more than the number loaded into the RPTC (provided that it is a repeatable 
instruction). Interrupts are masked out until the next instruction has been 
executed the specified number of times. (Interrupts cannot be allowed during the 
RPT/next instruction sequence, because the RPTC cannot be saved during a 
context switch.) The RPTC counter is cleared on a RS. 


RPT and RPTK are especially useful for repeating instructions, such as BLKP, 
BLKD, IN, MAC, MACD, NORM, OUT, TBLR, TBLW, and others. 


Words 1 
Cycles Class | (1) 
Repeatability Category X 
Example RPT DAT127 (DP = 31) 
SFR 
or 
RPT ad If current auxiliary register contains 4095. 
SFR 
Before Instruction After Instruction 
Data Data 
Memory Memory 
4095 4095 
ACC >12345678 acc [0] >12345 
; C 
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RPTK Repeat Instruction as Specified by Immediate Value RPTK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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[<label>] RPTK <constant> 


O < constant < 255 


PC} +-T >PC 
Constant ~ RPTC 


16 14. 13. ABA = 10 BS OF a ee 4. 3 2 iniies® 


1400 1 0 4°40] ~~ SBR Const 


The 8-bit immediate value is loaded into the RPTC (repeat counter). This causes 
the following instruction to be executed one time more than the number loaded 
into the RPTC (provided that it is a repeatable instruction). Interrupts are masked 
out until the next instruction has been executed the specified number of times. 
(Interrupts cannot be allowed during the RPT/next instruction sequence because 
the RPTC cannot be saved during a context switch.) The RPTC is cleared on a 
RS. 


RPT and RPTK are especially useful for repeating instructions, such as BLKP, 
BLKD, IN, MAC, MACD, NORM, OUT, TBLR, TBLW, and others. 


1 


Class IV (1) 

Category X 

LRLK AR2,>200 Load AR2 with the address of X. 
LARP 2 

ZAC Clear the accumulator. 

MPYK 0 Clear the P register. 

RPTK 2 Repeat next instruction 3 times. 
SQRA da Compute. K**2 +7 Yee 22. 

APAC 


RSXM Reset Sign-Extension Mode RSXM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] RSXM 


None 


(PC) +1~PC 
0 ~ SXM sign-extension mode status bit 


Affects SXM. 


tS. 4° 413 RW wf 8 FS B® 4 3 2 29509 
: i ee” aS SRR See: ees te. * a ee SS ys Pe ae eee 


The RSXM instruction resets the SXM status bit to logic zero, which suppresses 
sign-extension on shifted data memory values for the following arithmetic 
instructions: ADD, ADDT, ADLK, LAC, LACT, LALK, SBLK, SUB, and SUBT. 


The RSXM instruction affects the definition of the SFR instruction. SXM may 
also be loaded by the LST1 and SSXM instructions. 


1 
Class IV (1) 
Category C 


RSXM SXM is reset, disabling sign-extension on 
subsequent. instructions. 


4-115 


RTC Reset Test/Control Flag | RTC 


Assembler Syntax [<label>] RTC 


Operands None 
Execution (PG 1 
0 > TC test/control flag in status register ST1 
Affects TC. 
Encoding i a ta. Fe Se a SB SS ee ee AOS. 2) Bib 
1 1 D420 A 1 1 ap ot 1 2 eee See 0 
Description The TC (test/control) flag in status register ST1 is reset to logic zero. TC may also 
be loaded by the LST1 and STC instructions. 
Words 1 
Cycles Class IV (1) 
Repeatability Category C 
Example RTC TC (test/control) flag is reset to logic zero. 
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RTXM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Reset Serial Port Transmit Mode RTXM 


[<label>] RITXM 


None 

(PC) +.1.> PC 

0 > TXM transmit mode status bit 
Affects TXM mode bit. 


7. 34-43 he. tae eB SE Oe UAC 2S etic 
Ph eee eee a ee ae ee a oe ee ee 


The RTXM instruction resets the TXM status bit, which configures the serial port 
transmit section in a mode where it is controlled by an FSX (external framing 
pulse). The transmit operation is started when an external FSX pulse is applied. 
TXM may also be loaded by the LST1 and STXM instructions. 


1 
Class IV (1) 
Category C 


RTXM TXM is reset, configuring FSX as an input. 
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RXF Reset External Flag RXF 


Assembler Syntax [<label>] RXF 


Operands None 
Execution (Pe tt 2 Po 
O > XF external flag pin and status bit 
Affects XF. 
Encoding . -4 3S Pt 0 8 a oe OR a BS 2 BROOD 


1 i Wea. Bae! ° es Sie Meee: Bee) « aie « bee | Gee | eae oo: ee Bay Maa? 0 


Description The XF pin and XF status bit in status register ST1 are reset to logic zero. XF 
may also be loaded by the LST1 and SXF instructions. 

Words 1 

Cycles Class IV (1) 

Repeatability Category C 

Example RXF XF pin and status bit are reset to logic zero. 
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SACH Store High Accumulator with Shift SACH 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] SACH <dma>,[<shift>] 
[<label>] SACH {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<shift>[,<next ARP>]] 


0 < dma < 127 
O < next ARP < 7 
O < shift < 7 (defaults to 0) 


(PC) +1 >PC | 
16 MSBs of (ACC) x 28hift += ama 


Not affected by SXM. 
4.13 #2 41.6.9 ..8 <2 28 o§. 4.3.2 -nothot 


O 11a | Oat] —; Shite | Data Memory Address 
i epee Sey St ot Soe ae * e |) Shite | See Section 4.1 


The SACH instruction copies the entire accumulator into a shifter. It then shifts 
this entire 32-bit number anywhere from 0 to 7 bits, and copies the upper 16 bits 
of the shifted value into data memory. The accumulator itself remains unaffected. 


1 


Class Ill (1) 

Category A 

SACH DAT10,2 (DP = 4) 

or 

SACH *,2 If current auxiliary register contains 522. 


Before Instruction After Instruction 


c - 


Data Data 
Memory Memory >1082 
522 


522 
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SACL 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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Store Low Accumulator with Shift SACL 


[<label>] SACL <dma>,[<shift>] 
[<label>] SACL {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<shift>[,<next ARP>]] 


O < dma < 127 
O < next ARP < 7 
O < shift < 7 (defaults to 0) 


(PC) +1 >PC : 
16 LSBs of (ACC) x 28hift + dma 


Not affected by SXM. 
167A. ..43. 922 F138. 1G oe oF ee BK 3.2 ECS 


ee 1 Qe E> | Shite? 1 304 Data Memory Address 
0 =) 11 [ogee See Section 4.1 


The low-order bits of the accumulator, shifted left anywhere from 0 to 7 bits as 
specified by the shift code, are stored in data memory. The low-order bits are filled 
with zeros, and the high-order bits are lost. The accumulator itself is unaffected. 


1 


Class Ill (1) 

Category A 

SACL DAT11,5 (DP = 4) 

or 

SACL * 5 If current auxiliary register contains 523. 


Before Instruction After Instruction 


te C 


Data Data 
Memory Memory >8 420 
§23 523 


SAR Store Auxiliary Register SA 


Assembler Syntax 
Direct Addressing: [<label>] SAR <AR>,<dma> 
Indirect Addressing: [<label>] SAR <AR>,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O <dma < 127 
O < auxiliary register AR < 7 
O < next ARP < 7 


Execution (Poy + PC 
(AR) > dma 
Encoding 1%. 48 33-12 . 31 Bee Beis eB ek 4 |S se 7 DD 


Direct > Se 1 1 0 Auxiliary Data Memory Address 
Register 
Indirect 3-3 1 1 0 Auxiliary See Section 4.1 
Register 


Description The contents of the designated auxiliary register are stored in the addressed data 
memory location. 


When modifying the contents of the current auxiliary register in the indirect 
addressing mode, SAR ARn (when n = ARP) stores the value of the auxiliary 
register contents before it is incremented, decremented, or indexed by ARO. 


Words 1 
Cycles Class Ill (1) 
Repeatability Category B 
Example 1 SAR ARO ,DAT30 (DP = 6) 
or 
SAR ARO, * If current auxiliary register contains 798. 
Before Instruction After Instruction 
Data Data 
Example 2 LARP ARO 


Data 
Memory Memory 401 


1025 1025 


798 798 
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SBLK Subtract from Accumulator Long Immediate with Shift SBLK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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[<label>] SBLK <constant>[,<shift>] 


16-bit constant 
O < shift < 15 (defaults to QO) 


(PC) +2-—>PC 
(ACC) - [constant x 28hift] + ACC 


If SXM = 1: 
Then -32768 < constant < 32767. 
If SXM = 0: 


Then O < constant < 65535. 
Affects C and OV; affected by OVM and SXM. 
ho Nepae Y Ba e  S cat gs SUR 8 a SE” Re eee: eee Soe We een Coons eee 


i Tl0) mpmasna DO @ [em 011 
16-Bit Constant 


The immediate field of the instruction is subtracted from the accumulator. The 
result replaces the accumulator contents. SXM determines whether the constant 
is treated as a Signed two’s-complement number or as an unsigned number. The 
shift count is optional and defaults to zero. 


Z 
Class V (2) 
Category X 
SBLK 5 ke 
Before Instruction After Instruction 
ACC >3FCOEF ACC >3FIOEF 
& be 


SBRK Subtract from Auxiliary Register Short Immediate BRK 


Assembler Syntax [<label>] SBRK <constant> 


Operands O < constant < 255 
Execution (PCY 1 PC 
AR(ARP) - 8-bit positive constant ~ AR(ARP) 
Encoding 1S. 14-12 42-14 1 32 8 7 B24. S.. 2st 2 B 
Goi 3 A oa A ot 
Description The 8-bit immediate value is subtracted, right-justified, from the currently selected 


auxiliary register with the result replacing the auxiliary register contents. The 
subtraction takes place in the ARAU, with the immediate value treated as an 8-bit 
positive integer. 


Words 1 

Cycles Class IV (1) 

Repeatability Category X 

Example SBRK >FF (ARP = 7) 


Before Instruction After Instruction 
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SC Set Carry Bit SC 


Assembler Syntax [<label>] SC 


Operands None 
Execution (PC). +.1.7% PC 
1 > carry bit C in status register ST1 
Affects C. 
Encoding ga BRR OF TR ie TEES Ge a ere Vay PEER oR ° Sa: Sa ae ee Se. SE a ee © 
1 1 2 ee 5 Sree Lins s ieee * Pee 3 Saag 1 O°. 830 1 
Description The carry bit C in status register ST1 is set to logic one. The carry bit may also 
be loaded directly by the LST1 and RC instructions. 
Words 1 
Cycles Class IV (1) 
Repeatability Category C 
Example sc Carry bit C is set to logic one. 


4-124 


SFL Shift Accumulator Left SFL 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] SFL 


None 


(PC) +17 PC 

(ACC(31)) > C 
(ACC(30-0)) + ACC(31-1) 
0 + ACC(0) 


Affects C. 
Not affected by SXM bit. 


16 -t4. la. 12.11. 7 2... 8 7. BeBe MS 2 1 0 
1 1 8-7 1 1 FERS: * OUR: Beam - Hotes 1 8 0 
The SFL instruction shifts the entire accumulator left one bit. 


The least-significant bit is filled with a zero, and the most-significant bit is shifted 
into the carry bit. Note that SFL, unlike SFR, is unaffected by SXM. 


1 
Class IV (1) 
Category A 
SFL 
Before Instruction After Instruction 
ACC >B0001234 acc [1] [>60002468 
C C 


4-125 


SFR Shift Accumulator Right SFR 


Assembler Syntax [<label>] SFR 


Operands None 
Execution (PO) +t. -ePC 
If SXM = 0: 


Then (ACC(0)) > C 
(ACC(31-1)) ~ ACC (30-0) and 0 > ACC(31). 
If SXM = 1: 
Then (ACC(0)) 7 C 
(ACC(31-1)) ~ ACC(30-0) and (ACC(31)) ~ ACC(31). 


Affects C. 
Affected by SXM bit. 

Encoding SF 13 Se et = Pe Se Be Fee Bt 4. 3. Feige ow 
1 1 O.iesQ 454 1 1 0-33 Oss Bas: Ost 1 1 So 1 


Description The SFR instruction shifts the accumulator right one bit. 


If SXM = 1, the instruction produces an arithmetic right shift. The sign bit (MSB) 
is unchanged and is also copied into bit 30. Bit O is shifted into the carry bit. 


lf SXM = 0, the instruction produces a logical right shift. All of the accumulator 
bits are shifted by one bit to the right. The least-significant bit is shifted into the 
carry bit, and the most-significant bit is filled with a zero. 


Words 1 
Cycles Class IV (1) 
Repeatability Category A 
Example 1 SFR (SXM=0) 
Before Instruction After Instruction 
ACC >B0001234 acc [o] [>5800091A 
3 c 
Example 2 SFR (SXM=1) 
ACC >B0001234 acc [o| [>D800091A 
5 . 
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SFSM Set Serial Port Frame Sync Mode | SFSM 


Assembler Syntax [<label>] SFSM 


Operands None 
Execution (PG) + 17 PC 
1 ~ FSM status bit in status register ST1 
Affects FSM. 
Encoding 1 46 93 2 ee 1 Oo EO eR OS 8 ae 


1 : ie. SS ee 2 ee OO ee es a 1 1 


Description The SFSM instruction sets the FSM status bit to logic one. In this mode, an 
external FSR pulse is required for a receive operation, and an external FSX pulse 
is required if TXM = 0. If TXM = 1, FSX pulses are generated in the normal manner 
every time the transmit shift register XSR is loaded. See Section 3.7 for details 
on the operation of the serial port. FSM may also be loaded by the LST1 and 
RFSM instructions. 


Words 1 

Cycles Class IV (1) 

Repeatability Category C 

Example SFSM FSM is set, putting the serial port ina 


mode of operation where frame synchronization 
pulses are required for each word to be 
transmitted or received. 


4-127 


SHM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-128 


Set Hold Mode SHM 


[<label>] SHM 


None 


(PCy +:+.> PC 
1 > HM status bit in status register ST1 


Affects HM. 


Te ae 8 a a oe OR eh SI ee BS 2 atin ® 
1 A ee Ee Oo ee He ee ee Pe ke ee 1 


The SHM instruction sets the HM status bit to logic one. In this mode, the 
TMS320C25 is halted in the normal manner whenever HOLD is asserted, regard- 
less of the PC value or the state of the MP/MC pin. HM may also be loaded by 
the LST1 and RHM instructions. 


1 
Class IV (1) 
Category C 


SHM HM is set, implementing the normal 
(TMS32020-type) hold mode of operation. 


SOVM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Set Overflow Mode SOVM 


[<label>] SOVM 


None 


(PC) -+ +> PC 
1 > overflow mode (OVM) status bit 


Affects OVM. 


Te pe ee Se SS es ee ee 8 
1 1 SS «Oe: 1 > Rape i iro: » SEERA : ees + ROR + eee | eee? ae 1 


The OVM status bit is set to logic one, which enables the overflow (saturation) 
mode. If an overflow occurs with OVM set, the overflow flag OV is set, and the 
accumulator is set to the largest representable 32-bit positive (>7FFFFFFF) or 
negative (>80000000) number according to the direction of overflow. OVM may 
also be loaded by the LST and ROVM instructions. 


1 
Class IV (1) 
Category C 


SOVM The overflow mode bit OVM is set, enabling 
the overflow mode on any subsequent 
arithmetic operations. 
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PAC ubtract P Register from Accumulator SPAC 


Assembler Syntax [<label>] SPAC 


Operands None 


Execution (PC) + 1 7-PC 
(ACC) - (shifted P register) ~ ACC 


Affects C and OV; affected by PM and OVM. 
Not affected by SXM. 


Encoding io a a) he ee ee ee ced a Be oe LD 
A NS. ae ee Oe Ee ee eS Ee: a. 0 


Description The contents of the P register, shifted as defined by the PM status bits, are 
subtracted from the contents of the accumulator. The result is stored in the 
accumulator. Note that SPAC is unaffected by SXM; the P register is always 
sign-extended. SPAC is a subset of LTS, MPYS, and SQRS. 


Words 1 

Cycles Class IV (1) 
Repeatability Category B 

Example SPAC (PM = 0) 


Before Instruction After Instruction 


ACC >$-C ACC >1 8 
C 
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SPH Store High P Register SPH 


Assembler Syntax 
Direct Addressing: [<label>] SPH <dma> 
Indirect Addressing: [<label>] SPH {*|*+|*-|*0+]/*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PO) + Te PC 


(PR shifter output (31-16)) > dma 
Affected by PM. 
Encoding 1D HH 3:72 WS WW 8.8. - 8B B&B 4-3 2 .wtibos 


Direct : 1 1 1 1 2 eas: Data Memory Address 
wdaees 0 FTO a Be AE See Section 4.1 


Description The high-order bits of the P register, shifted as specified by the PM bits, are stored 
in data memory. Neither the P register nor the accumulator are affected by this 
instruction. High-order bits are sign-extended when the right-shift by 6 mode is 
selected. Low-order bits are taken from the low P register when left-shifts are 


selected. 
Words 1 
Cycles Class Ill (1) 
Repeatability Category B 
Example SPH DAT3 (DP = 4, PM = 2) 
or 
SPH * If current auxiliary register contains 515. 


Before Instruction After Instruction 


P >FEO79844 P >FEO79844 
Data Data 
Memory >456/7 Memory: >EO079 
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PL tore Low P Register SPL 


Assembler Syntax 
Direct Addressing: [<label>] SPL <dma> 
Indirect Addressing: [<label>] SPL {*|*+|*-|*0+|*0-|"BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP < 7 
Execution (PO) +1 FC 


(PR shifter output (15-0)) > dma 
Affected by PM. 
Encoding © THATS 42-86 WW 2 B- o. 2e. e.4- SUZ phibs 


Direct 4 aire 1 1 1 1 «aie Data Memory Address 
indinasta <0 1 1-4-9 oO 4 8 01-74 See Section 4.1 


Description The low-order bits of the P register, shifted as specified by the PM bits, are stored 
in data memory. Neither the P register nor the accumulator are affected by this 
instruction. High-order bits are taken from the high P register when the right-shift 
by 6 mode is selected. Low-order bits are zero-filled when left-shifts are selected. 


Words 1 
Cycles Class Ill (1) 
Repeatability Category B 
Example SPL DAT3 (DP = 4, PM = 2) 
or 
SPL x If current auxiliary register contains 515. 


Before Instruction After Instruction 


P >FEO079844 P >FEO79844 
Data Data 

bay 9 >4567 ee >8440 
5 
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SPM Set P Register Output Shift Mode SPM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] SPM  <constant> 


0 < constant < 3 


(Pt) +1. PG 
Constant ~ product register shift mode (PM) status bits 


Affects PM. 
16> 34-13. 12..11- the SBS 8 eee. 4 Be 2 EB 


Pont OO Ot ee oO ee a et a ee 


The two low-order bits of the instruction word are copied into the PM field of 
status register ST1. The PM status bits control the P register output shifter. This 
shifter has the ability to shift the P register output either one or four bits to the 
left or six bits to the right, or to perform no shift. The bit combinations and their 
meanings are shown below. 


PM ACTION 

00 No shift of multiplier output 

01 Output left-shifted 1 place and zero-filled 

10 Output left-shifted 4 places and zero-filled 

11 Output right-shifted 6 places, sign-extended, and LSB bits lost. 


The left-shifts allow the product to be justified for fractional arithmetic. The 
right-shift by six bits has been incorporated to implement up to 128 multiply- 
accumulate processes without the possibility of overflow occurring. PM may also 
be loaded by an LST1 instruction. 


1 
Class IV (1) 
Category X 


SPM 3 Product register shift mode 3 is selected, 
causing all subsequent transfers from the 
product register to the ALU to be shifted 
to the right six places. 
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SQRA Square and Accumulate Previous Product SQRA 


Assembler Syntax 
Direct Addressing: [<label>] SQRA <dma> 
Indirect Addressing: [<label>] SQRA {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP < 7 
Execution (Peis to 


(ACC) + (shifted P register) ~ ACC 

(dma) > T register 

(dma) x (dma) ~ P register 

Affects C and OV; affected by PM and OVM. 


Encoding 1 84 TOS eA Oe Be Picea cums 4 3. 2.1. 0 


Direct Teas * aia 1 1 geo al, Data Memory Address 
nding oe 1 OF Be a See Section 4.1 


Description The contents of the P register, shifted as defined by the PM status bits, are added 
to the accumulator. The addressed data memory value is then loaded into the T 
register, squared, and stored in the P register. 


Words 1 
Cycles Class | (1) 
Repeatability Category A 
Example SORA DAT30 (DP = 6, PM = 0) 
or 
SQRA * If current auxiliary register contains 798. 
Before Instruction After Instruction 
Data Data 
Memory Memory 
798 798 
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SQRS Square and Subtract Previous Product SQRS 


Assembler Syntax 
Direct Addressing: [<label>] SQRS <dma> 
Indirect Addressing: [<label>] SQRS {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PC) + TPG 


(ACC) - (shifted P register) ~ ACC 
(dma) ~ T register 
(dma) x (dma) ~ P register 


Affects C and OV; affected by PM and OVM. 


Encoding to: Ve Pe Oe. 04 Oe SS 3 od. 1B OSS saebea S 0 
Direct fae : ee 1 Ny 0 es Data Memory Address 
indifeet| <0 e pate sieges: epee See Section 4.1 
Description The contents of the P register, shifted as defined by the PM status bits, are 


subtracted from the accumulator. The addressed data memory value is then loaded 
into the T register, squared, and stored into the P register. 


Words 1 
Cycles Class | (1) 
Repeatability Category A 
Example SORS DATS (DP = 6, PM = 0) 
or 
SORS * If current auxiliary register contains 777. 
Before Instruction After Instruction 
Data Data 
444 777 


SST Store Status Register STO SST 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-136 


Direct 


Indirect 


[<label>] SST <dma> 
[<label>] SST {*|*+|*-|*0+]|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


recs *- 13 PG 
(status register STO) ~ dma 


TO. 34-135 F241. Teele Boh Bie 4. Se 2 7 0 


2 ae 1 1 1 ‘9 Saas * oak & as Data Memory Address 


0 See Section 4.1 


Status register STO is stored in data memory. 


In the direct addressing mode, status register STO is always stored in page O 
regardless of the value of the DP register. The processor automatically forces the 
page to be O, and the specific location within that page is defined in the 
instruction. Note that the DP register is not physically modified. This allows 
storage of the DP register in the data memory on interrupts, etc., in the direct 
addressing mode without having to change the DP. In the indirect addressing 
mode, the data memory address is obtained from the auxiliary register selected. 
(See the LST instruction for more information. ) 


The SST instruction can be used.-to store status register STO after interrupts and 
subroutine calls. The STO contains the status bits: OV (overflow flag) bit, OVM 
(overflow mode) bit, INTM (interrupt mode) bit, ARP (auxiliary register pointer) 
bit, and DP (data memory page pointer) bit. The status bits are stored in the data 
memory word as follows: 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
Cane Towjovey1-pwrg— 


Note that SST * may be used to store status register STO anywhere in data memory, 
while SST in direct mode its forced to page 0. 


1 

Class Ill (1) 

Category C 

SST DAT96 (DP = don’t care) 

or 

POY * If current auxiliary register contains 96. 


Before Instruction After Instruction 
Status 


Status 
Register >A408 Register >A408 


STO STO 


Data Data 
Memory Memory >A408 
96 96 


T1 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Direct 


Indirect 


tore Status Register ST1 T1 


[<label>] SST1 <dma> 
[<label>] SST1 {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(PO): +A.* PC 
(status register ST1) ~ dma 


ip 4. hs. i. ow U8 ae BE See we es 


ar 
See ee ee MR HSS a A Es Data Memory Address 
Oni y Ro lia i teasO- yas S14 aly See Section 4.1 


Status register ST1 is stored in data memory. 


In the direct addressing mode, status register ST1 is always stored in page 0 
regardless of the value of the DP register. The processor automatically forces the 
page to be O, and the specific location within that page is defined in the 
instruction. Note that the DP register is not physically modified. This allows the 
storage of the DP in the data memory on interrupts, etc., in the direct addressing 
mode without having to change the DP. In the indirect addressing mode, the data 
memory address is obtained from the auxiliary register selected. (See the LST1 
instruction for more information. ) 


This instruction can be used to store status register ST1 after interrupts and 
subroutine calls. The ST1 contains the status bits: CNF (RAM configuration 
mode) bit, TC (test/control) bit, SXM (sign-extension mode) bit, C (carry) bit, 
HM (hold mode) bit, FSM (frame synchronization mode) bit, XF (external flag) 
bit, FO (serial port format), TXM (transmit mode) bit, ARB (auxiliary register 
pointer buffer), and PM (product register shift mode) bit. The status bits are stored 
in the data memory word as follows: 


1534 #T3 2. 11 10 9 8 7 6 5 4 3 2 1 0 
_ ARB [CNF] TC |SxM] Cc | 11 [HM JFSM] XF | FO [TXM] PM | 


Note that SST1 * may be used to store status register ST1 anywhere in data 
memory, while SST1 in direct mode is forced to page 0. 


1 

Class Ill (1) 

Category C 

SST1 DAT97 (DP = don't care) 

SST1 * If current auxiliary register contains 97. 


Before Instruction After Instruction 
Status 


Status 
Register >A7EO Register >A7EO 
ST1 ST1 


Data Data 
Memory > Memory >A7EO 
97 97 


> 
aye 
ev) 
~~ 


SSXM Set Sign-Extension Mode SSXM 


Assembler Syntax [<label>] SSXM 


Operands None 
Execution (PC) +. + PC 
1 ~ SXM status bit in status register ST1 
Affects SXM. 
Encoding Oe TA ee ee ea Pe ee ee a oe ee, Be 


1 3 OU 9 eam: es Hees Ae, oc ee OO 7 1 1 


Description The SSXM instruction sets the SXM status bit to logic 1, which enables sign- 
extension on shifted data memory values for the following arithmetic instructions: 
ADD, ADDT, ADLK, LAC, LACT, LALK, SBLK, SUB, and SUBT. 


SSXM also affects the definition of the SFR instruction. SXM may also be loaded 
by the LST1 and RSXM instructions. 


Words 1 

Cycles Class IV (1) 

Repeatability Category C 

Example SSXM SXM is set, enabling sign extension on 


subsequent instructions. 


4-138 


TC 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


et Test/Control Fla TC 


[<label>] STC 


None 


(PC) +1 = PC 
1 > TC test/control flag in status register ST1 


Affects TC. 


$5 34.339 $2 $1.70" -'9 58 <7 66-36 4 3 2 ortbesd 
Rhee. eee A ee ee a ee ae OE Op a OR ae 


The TC (test/control) flag in status register ST1 is set to logic one. TC may also 
be loaded by the LST1 and RTC instructions. 


1 
Class IV (1) 
Category C 


STC TC (test/control) flag is set to logic one. 
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STXM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-140 


Set Serial Port Transmit Mode STXM 


[<label>] STXM 


None 


(PG) +: 1.2 PC 
1 7 TXM status bit in status register ST1 


Affects TXM. 


Fo 24-13 -62 81 40. --@ 28... oF 88 36. A 3  2-enthowd 
1 TOD eRe 74 1 1 Ue oo ee ea OD DD 1 


The STXM instruction sets the TXM status bit to logic 1, which configures the 
serial port transmit section to a mode where the FSX pin behaves as an output. 
A pulse is produced on the FSX pin each time the DXR register is loaded internally. 
The transmission is initiated by the negative edge of this pulse. TXM may also 
be loaded by the LST1 and RTXM instructions. If the FSM status bit is a logic 
zero and serial port operation has already started, the FSX pin will be driven low 
if TXM = 1. 


1 
Class IV (1) 
Category C 


STXM TXM is set, configuring FSX as an output. 


SUB 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


Subtract from Accumulator with Shift SUB 


[<label>] SUB <dma>,[<shift>] 
[<label>] SUB {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<shift>[,<next ARP>]] 


O < dma < 127 
O < next ARP < 7 
0 < shift < 15 (defaults to 0) 


(PC) +17 PC | 
(ACC) - [(dma) x 2Shift] + ACC 


If SXM = 1: 
Then (dma) is sign-extended. 
lf SXM = 0: 


Then (dma) is not sign-extended. 
Affects C and OV; affected by OVM and SXM. 
18: 4485.78. 228 9374.30) GB a. diac Bo. asta 


Qh rs 2g i ee a Data Memory Address 
ee ee eee Se See Section 4.1 


The contents of the addressed data memory location are left-shifted and 
subtracted from the accumulator. During shifting, low-order bits are zero-filled. 
High-order bits are sign-extended if SXM = 1 and zero-filled if SXM = 0. The 
result is stored in the accumulator. 


1 

Class | (1) 

Category A 

SUB DATS8O (DP = 8) 

or 

SUB If current auxiliary register contains 1104. 

Before Instruction After Instruction 

Data Data 

Memory >1 1 Memory a 
1104 1104 
ACC >24 acc [1] >13 

C c 
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SUBB 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


4-142 


Subtract from Accumulator with Borrow SUBB 


[<label>] SUBB <dma> 
[<label>] SUBB_ {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PL 4 Pe 
(ACC) - (dma) - (C) > ACC 


Affects C and OV; affected by OVM. 
6. FA. 135 1 21 ke ele o. tebe aca & 3-2 T- 0 


ee ee £5) 25 ee Be REE Data Memory Address 
1 See Section 4.1 


The contents of the addressed data memory location and the value of the carry 
bit are subtracted from the accumulator. The carry bit is then affected in the normal 
manner (see Section 3.4.3). 


1 

Class | (1) 

Category B 

SUBB DATS5 (DP = 8) 

Or 

SUBB * If current auxiliary register contains 1029. 

Before Instruction After Instruction 

Data Data 

Memory Memory 
1029 1029 


nce cc [bo] [SFFFFFFFF 
C C 


In the above example, C is originally zeroed, presumably from the result of a 
previous subtract instruction that performed a borrow. Thus, 6 - 6 - (0) = -1 
was the effective operation performed, generating another borrow (and resetting 
Carry again) in the process. 


The SUBB instruction can be used in performing multiple-precision arithmetic. 


SUBC 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


Conditional Subtract SUBC 


[<label>] SUBC <dma> 
[<label>] SUBC {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +1 7>PC 
(ACC) - [(dma) x 219] > ALU output 


If ALU output > 0: 
Then (ALU output) x 2 + 1 > ACC; 
Else (ACC) x 2 ~ ACC. 


Affects C and OV. , 
Not affected by OVM (no saturation) or SXM. 


to e412) is it te Se” ee te 


BGAow Gro 2Om sho ngeca4 1} 0 Data Memory Address 
OS. iets Woe stored t pits See Section 4.1 


The SUBC instruction performs conditional subtraction, which may be used for 
division. The 16-bit dividend is placed in the low accumulator, and the high 
accumulator is zeroed. The divisor is in data memory. SUBC is executed 16 times 
for 16-bit division. After completion of the last SUBC, the quotient of the division 
is in the lower-order 16-bit field of the accumulator, and the remainder is in the 
high-order 16 bits of the accumulator. SUBC assumes the divisor and the divi- 
dend are both positive. 


If the 16-bit dividend contains less than 16 significant bits, the dividend may be 
placed in the accumulator left-shifted by the number of leading non-significant 
zeroes. The number of executions of SUBC is reduced from 16 by that number. 
One leading zero is always significant. 


Note that SUBC affects OV but is not affected by OVM, and therefore the accu- 
mulator does not saturate upon positive or negative overflows when executing 
this instruction. 


1 

Class | (1) 

Category A 

RPTK is 

SUBC DAT2 (DP = 4) 

or 

RPTK a 

SUBC = If current auxiliary register contains 514. 

Before Instruction After Instruction 

Data Data 

Memory Memory 
514 514 
ACC >4 1 ACC >20009 

Cc C 


SUBH Subtract from High Accumulator SUBH 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


[<label>] SUBH <dma> 
[<label>] SUBH {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


QO < dma < 127 
O < next ARP < 7 


(PC) +1-7PC 
(ACC) - [(dma) x 219] + ACC 


Affects C and OV; affected by OVM. 
1 46— 43 a 1 40. a ie ee eae A Se 1D 


Direct 3 a | i ee eS ae oO Data Memory Address 


Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


4-144 


eee ee hes: oe ae Caer ae See Section 4.1 


The contents of the addressed data memory location are subtracted from the upper 
16 bits of the accumulator. The 16 low-order bits of the accumulator are unaf- 
fected. The result is stored in the accumulator. The carry bit C is reset if the result 
of the subtraction generates a borrow; otherwise, C is unaffected. 


The SUBH instruction can be used for performing 32-bit arithmetic. 


1 

Class | (1) 

Category B 

SUBH DAT33 (DP = 6) 

or 

SUBH * If current auxiliary register contains 801. 
Before Instruction After Instruction 

Data Data 
Memory Memory > 


801 801 


>A0013 ACC >60013 
C 


> 

QO 

o) 
obs] 


UBK Subtract from Accumulator Short Immediate UBK 


Assembler Syntax [<label>] SUBK <constant> 


Operands O < constant < 255 


Execution ta Bee Beer a * 
(ACC) - 8-bit positive constant ~ ACC 


Affects C and OV: affected by OVM. 
Not affected by SXM. 


Encoding 1. Sie ee te TT ee Be ie Se a a ge 0 
DE Se Gee VN eee | ee 
Description The 8-bit immediate value is subtracted, right-justified, from the accumulator with 


the result replacing the accumulator contents. The immediate value is treated as 
an 8-bit positive number, regardless of the value of SXM. 


Words 1 
Cycles Class IV (1) 
Repeatability Category X 
Example SUBK > 2 
Before Instruction After Instruction 
acc ace El 
C C 


4-145 


Subtract from Low Accumulator 


SUBS with Sign-Extension Suppressed SUBS 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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[<label>] SUBS <dma> 
[<label>] SUBS {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
0 < next ARP < 7 


(PC) +1 PC 
(ACC) - (dma) + ACC 


Affects C and OV; affected by OVM. 
Not affected by SXM. 


15. 43f¢ 13 Te 24). PO |S ee) SQ RR Sie ote ear 


: 
Direct Oita A Of ca Bo: 4 0 4 Ae Data Memory Address 


1 See Section 4.1 


The contents of the addressed data memory location are subtracted from the 
accumulator with sign-extension suppressed. The data is treated as a 16-bit 
unsigned number, regardless of SXM. The accumulator behaves as a signed 
number. SUBS produces the same result as a SUB instruction with SXM = 0 and 
a shift count of 0. 


1 


Pe a ts a ee Ce 


Class | (1) 
Category B 
SUBS DAT2 (DP = 16) 
or 
SUBS * If current auxiliary register contains 2050. 
Before Instruction After Instruction 
Data Data 
Memory >FO003 Memory >FO003 
050 20 
Before Instruction After Instruction 
Acc >F108 Acc 


C C 


Subtract from Accumulator 


SUBT with Shift Specified by T Register SUBT 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] SUBT <dma> 
[<label>] SUBT {*|*+|*-|*0+]*0-|*BRO+|*BRO-}[,<next ARP>] 


O< dma < 127 

O < next ARP < 7 

(PC) + 1 PC 

(ACC) - [(dma) x aT register(3-0)} > (ACC) 


If SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 
Then (dma) is not sign-extended. 


Affects C and OV; affected by SXM and OVM. 
2D ee BS TS Te BB a ee ee age ee 


Od arieGe Or Ma We stT OO Data Memory Address 
A Oe oe Se ee ae See Section 4.1 


The data memory value, left-shifted as defined by the four LSBs of the T register, 
is subtracted from the accumulator. The result replaces the accumulator contents. 
Sign-extension on the data memory value is controlled by the SXM status bit. 


1 


Class | (1) 

Category A 

SUBT DAT127 (DP = 4) 

or 

SUBT al If current auxiliary register contains 639. 


Before Instruction After Instruction 
Data Data 


Memory Memory : 
639 639 
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XF 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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Set External Fla XF 


[<label>] SXF 


None 


(PG) +4°7 PC 
1 > external flag (XF) pin and status bit 


Affects XF. 


13.78 APS Ae a Ee Seog) eee a oe OTD 
PS So. oO ae 8 oa de eee 1 


The XF pin and the XF status bit in status register ST1 are set to logic 1. XF may 
also be loaded by the LST1 and RXF instructions. 


1 
Class IV (1) 
Category C 


SXF The XF pin and status bit are set to logic l. 


TBLR 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Table Read TBLR 


[<label>] TBLR <dma> 
[<label>] TBLR {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +17PC 
(PFC) > MCS 
(ACC(15-0)) > PFC 


While (repeat counter) ¢ 0: 
(pma, addressed by PFC) ~ dma, 
Modify AR(ARP) and ARP as specified, 
(PRG) + 1 > PFE, 
(repeat counter) - 1 ~ repeat counter. 


(pma, addressed by PFC) ~ dma 
Modify AR(ARP) and ARP as specified. 
(MCS) ~ PFC 


to $4 (3 82:91 @0 18 cS cf 26 33. 4 3 2 grtoos? 


Direct « ae O°: T 1 G- {0 £0 Data Memory Address 


Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


OT) Ohi of oe 7d. TOL oS See Section 4.1 


The TBLR instruction transfers a word from a location in program memory to a 
data memory location specified by the instruction. The program memory address 
is defined by the low-order 16 bits of the accumulator. For this operation, a read 
from program memory is performed, followed by a write to data memory. When 
in the repeat mode, TBLR effectively becomes a single-cycle instruction, and the 
program counter that contains the ACCL is incremented once each cycle. If the 
MP/MC pin is low at the time of execution of this instruction and the program 
memory address used is less than 4096, an on-chip ROM location will be read. 


1 


Class XI (4) 

Category A 

TBLR DAT6 (DP = 4) 

TBLR * If current auxiliary register contains 518. 


Before Instruction After Instruction 


Program Program 
memoy = [___>306] — Memory 
a0 30 


Data Data 
518 


518 


TBLW Table Write TBLW 
Assembler Syntax 
Direct Addressing: [<label>] TBLW <dma> 
Indirect Addressing: [<label>] TBLW_ {*|*+|*-|*0+|*0O-|*BRO+|*BRO-}[,<next ARP>] 
Operands O < dma < 127 
O < next ARP <7 
Execution (PLjo+ 1. PC 
(PFC) ~ MCS 
(ACC(15-0)) ~ PFC 
While (repeat counter) # 0: 
(dma) ~ pma, addressed by PFC, 
Modify AR(ARP) and ARP as specified, 
(PEC) + + >? FG 
(repeat counter) - 1 ~ repeat counter. 
(dma) ~ pma, addressed by PFC, 
Modify AR(ARP) and ARP as specified. 
(MCS) > PFC 
Encoding 15. 94 2. 1. 10-38 6 $22.89 0 
Direct * ie 1 1 * Dies 1 See ce Data Memory Address 
Indirect 1 See Section 4.1 


Description 


Words 
Cycles 
Repeatability 


Example 
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The TBLW instruction transfers a word in data memory to program memory. The 
data memory address is specified by the instruction, and the program memory 
address is specified by the lower half of the accumulator. A read from data memory 


is followed by a write to program memory to complete the instruction. When in 


the repeat mode, TBLW effectively becomes a single-cycle instruction, and the 


program counter that contains the ACCL is incremented once each cycle. If the 
MP/MC pin is low at the time of execution of this instruction and the program 
memory address used is less than 4096, an on-chip ROM location will be 
addressed but not written to. 


1 


Class XII (3) 
Category A 


TBLW 
TBLW 


ACC 


Data 
Memory 
4101 


Program 
Memory 
599 


(DP = 32) 


If current auxiliary register contains 4101. 


Before Instruction 


>4339 


ACC 


Data 
Memory 
4101 


Program 
Memory 
599 


After Instruction 


>4339 


>4339 


TRAP Software Interrupt TRAP 


Assembler Syntax [<label>] TRAP 


Operands None 
Execution (PC). + 1. ~ stack 
a0 BG 


Not affected by INTM; does not affect INTM. 


Encoding 15. 14. 1S V2 TT (che OAS CSS Mjsoey 4 6SlCUl TCD 
1 ie * ee Soe 1 +, yal Ge owe Me 1 1 1 0 


Description The TRAP instruction is a software interrupt that transfers program control to 
program memory location 30 and pushes the program counter plus one onto the 
hardware stack. The instruction at location 30 may contain a branch instruction 
to transfer control to the TRAP routine. Putting the PC + 1 onto the stack enables 
an RET instruction to pop the return PC (points to instruction after the TRAP) from 


the stack. 
Words 1 
Cycles Class VIII (3) 
Repeatability Category X 
Example TRAP Control is passed to program memory 
location 30. PC + 1 is pushed onto 
the stack. 
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XOR 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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Exclusive-OR with Accumulator XOR 


[<label>] XOR <dma> 
[<label>] XOR {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +:1-~PC 
(ACC(15-0)).XOR.dma ~ ACC(15-0) 
(ACC(31-16)) ~ ACC(31-16) 

Not affected by SXM. 


ae te ee. a ee ee ee ee ee 


ie ee ee a eS Data Memory Address 


0 See Section 4.1 


The low half of the accumulator is exclusive-ORed with the contents of the 
addressed data memory location. The upper half of the accumulator is not affected 
by this instruction. 


1 


Class | (1) 

Category B 

XOR DAT127 (DP = 511) 

or 

XOR * If current auxiliary register contains 65535. 


Before Instruction After Instruction 


Data Data 
Memory >FOFO Memory >FOFO 


65535 65535 


C C 


XORK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


XOR Immediate with Accumulator with Shift XORK 


[<label>] XORK <constant>[,<shift>] 


16-bit constant 
O < shift < 15 (defaults to 0) 


(PC) +2—->PC | 
(ACC(30-0)).XOR.[constant x 2Shift ] + ACC(30-0) 
(ACC(31)) > ACC(31) 


Not affected by SXM. 
2 ee ee ae le ee ee A Oe eae ne 


(as Gee Gl akan eee Oh Ss Rr ee en ee re eee 
16-Bit Constant 


The left-shifted 16-bit immediate constant is exclusive-ORed with the accu- 
mulator, leaving the result in the accumulator. Low-order bits below and high- 
order bits above the shifted value are treated as zeroes, thus not affecting the 
corresponding bits of the accumulator. Note that the most-significant bit of the 
accumulator is not affected, regardless of the shift code value. 


2 
Class V (2) 
Category X 
XORK >FFFF,8 
Before Instruction After Instruction 
ACC >12345678 ACC >12CBA978 
C C 
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ZAC Zero Accumulator ZAC 


Assembler Syntax [<label>] ZAC 


Operands None 
Execution (PC) + 1.7 PC 
0-7 ACC 
Encoding ie 18 43 32-.47.. 30. ase a). 4 CZ eT 
1 1 ae Bees Raat Elna =< PSS, * Geer | Seen © Seas ee * 0 
Description The contents of the accumulator are replaced with zero. The ZAC instruction has 
been implemented as a special case of LACK. (ZAC assembles as LACK 0.) 
Words 1 
Cycles Class IV (1) 
Repeatability Category X 
Example ZAC 
Before Instruction After Instruction 
ACC >A5A5A5A5 ACC 
+ C 
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ZALH Zero Low Accumulator and Load High Accumulator ZALH 


Assembler Syntax 
Direct Addressing: [<label>] ZALH <dma> 
Indirect Addressing: [<label>] ZALH {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PC) ti PC 


0 ~ ACC(15-0) 
(dma) ~ ACC(31-16) 


Encoding 18. aol 12 1 A. So oe ee Re Se ee 0 


Direct O24 O60 ©=0 VO: OD +0 Data Memory Address 
Indirect | ee 5. ee he as oD Ob Fo See Section 4.1 


Description ZALH loads a data memory value into the high-order half of the accumulator. The 
low-order bits of the accumulator are zeroed. 


ZALH is useful for 32-bit arithmetic operations. 


Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example ZALH DAT3 (DP = 32) 
or 
ZALH * If current auxiliary register contains 4099. 
Before Instruction After Instruction 
Data Data 
Memory >3 F071 Memory >3 F001 
4099 4099 
ACC >7-7-F-F-FF ACC >3F010000 
if i 
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Zero Low Accumulator, Load High Accumulator 
ZALR with Rounding ZALR 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


[<label>] ZALR <dma> 
[<label>] ZALR {*|*+|*-|*0+|*O-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
>8000 ~ ACC(15-0) 
(dma) ~ ACC(31-16) 


> 4) 2: G47). OO oS: O8...07 28 Obs a4ics 2... F- 2D 


Direct Coy 1 1 1 2 Be 1 Data Memory Address 


Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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Fes RE ces SE SS ES See Section 4.1 . 


The ZALR instruction loads a data memory value into the high-order half of the 
accumulator with rounding the value by adding 1/2 LSB; i.e., the 15 low bits (bits 
0-14) of the accumulator are set to zero and bit 15 of the accumulator is set to 
one. 


ZALR is a derivative instruction from ZALH. 


1 


Class | (1) 

Category C 

ZALR DAT3 (DP = 32) 

or 

ZALR * If current auxiliary register contains 4099. 

Before Instruction After Instruction 

Data Data 

Memory >3 FO 1 Memory 2S ret 
4099 4099 
ACC >77 FR FF ACC >3F018000 


C C 


Zero Accumulator, Load Low Accumulator 
ZALS with Sign-Extension Suppressed ZALS 


Assembler Syntax 
Direct Addressing: [<label>] ZALS <dma> 
Indirect Addressing: [<label>] ZALS {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PL) + 1% PG 


0 ~ ACC(31-16) 
(dma) ~ ACC(15-0) 


Not affected by SXM. 
Encoding 1D... 34...13-42. 71 49. 9 aa oe er oe ee 0 


S 7 
Direct 4 e .8: oe. OF ee Data Memory Address 
indirect} 0 1 0 0 0 0. 0 1 See Section 4.1 


Description The contents of the addressed data memory location are loaded into the 16 
low-order bits of the accumulator. The upper half of the accumulator is zeroed. 
The data is treated as a 16-bit unsigned number rather than a two’s-complement 
number. Therefore, there is no sign-extension with this instruction, regardless 
of the state of SXM. (ZALS behaves the same as a LAC instruction with no shift 


and SXM = 0.) 
ZALS is useful for 32-bit arithmetic operations. 
Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example ZALS DAT1 (DP = 6) 
or 
ZALS * If current auxiliary register contains 769. 
Before Instruction After Instruction 
Data Data 
Memory EOF PP Memory SF PEP 
769 769 
ACC >7FF00033 ACC >F7FF 
G CG 
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5. Software Applications 


The TMS320C25 microprocessor/microcomputer design emphasizes overall speed, 
communication, and flexibility. Control signals and instructions provide block- 
memory transfers, communication with off-chip devices (both serial and parallel), 
and multiprocessing possibilities. The instructions are tailored to digital signal proc- 
essing tasks, providing single-cycle multiply/accumulates, adaptive filtering support, 
and many other features. There is also instruction support for floating-point, 
extended-precision, and logical processing. Increased throughput for many digital 
signal processing (DSP) applications is accomplished by the_ single-cycle 
multiply/accumulate instructions, two large on-chip RAM blocks, eight auxiliary 
registers with a dedicated arithmetic unit, a serial port, hardware timer, and single- 
cycle |/O. 


This section provides explanations of how to use the various TMS320C25 processor 
and instruction set features along with assembly language coding examples. More 
information about specific applications can be found in the book, Digital Signal 
Processing Applications with the TMS320 Family. 


Major topics discussed in this section are listed below. 


@ Processor Initialization (Section 5.1 on page 5-2) 


@ Program Control (Section 5.2 on page 5-4) 
Subroutines 
Software stack 
Timer operation 
Single-instruction loops 
Computed GOTOs 


@ Interrupt Service Routines (Section 5.3 on page 5-11) 
Context switching 
Interrupt priority 


@ Memory Management (Section 5.4 on page 5-15) 
Block moves 
Configuring on-chip RAM 
Using on-chip RAM for program execution 


@ Fundamental Logical and Arithmetic Operations (Section 5.5 on page 5-23) 
Status register effects 
Bit manipulation 


@ Advanced Arithmetic Operations (Section 5.6 on page 5-25) 
Overflow management 
Scaling 
Moving data 
Multiplication 
Division 
Floating-point arithmetic 
Indexed addressing 
Extended-precision arithmetic 


@ Application-Oriented Operations (Section 5.7 on page 5-42) 
Companding 
Filtering 
Fast Fourier Transforms (FFT) 
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Software Applications 


5.1 Processor Initialization 


5-2 


Prior to the execution of a digital signal processing algorithm, it is necessary to 
initialize the processor. Generally, initialization takes place anytime the processor is 
reset. 


When reset is activated by applying a low level to the RS (reset) input for at least 
three cycles, the TMS320C25 terminates execution and forces the program counter 
(PC) to zero. Program memory location 0 normally contains a B (branch) instruction 
in order to direct program execution to the system initialization routine. The hardware 
reset also initializes various registers and status bits. 


After reset, the processor should be initialized to meet the requirements of the system. 
Instructions should be executed that set up operational modes, memory pointers, 
interrupts, and the remaining functions necessary to meet system requirements. 


To configure the processor after reset, the following internal functions should be 
initialized: 


Memory-mapped registers 

Interrupt structure 

Mode control (OVM, SXM, HM, FSM, FO, TXM, PM) 
Memory control (CNF) 

Auxiliary registers and the auxiliary register pointer (ARP) 
& Data memory page pointer (DP). 


The OVM (overflow mode), TC (test/control flag), and IMR (interrupt mask register) 
bits are not initialized by reset. The auxiliary register pointer (ARP), auxiliary register 
pointer buffer (ARB), and data memory page pointer (DP) are also not initialized 
by reset. 


Example 5-1 shows coding for initializing the TMS320C25 to the following machine 
state, in addition to the initialization performed during the hardware reset: 


All interrupts enabled 

Overflow mode (OVM) disabled 

Data memory page pointer (DP) set to zero 
Auxiliary register pointer (ARP) set to seven 
Internal memory filled with zero. 


Software Applications 


Example 5-1. Processor Initialization 


"PROCESSOR INITIALIZATION ' 
"EXAMPLE ' 
RESET, INTO, INT1,INT2 
TINT,RINT,XINT,USER 
ISRO,ISR1,ISR2 

TIME ,RCV,XMT,PROC 


* PROCESSOR INITIALIZATION 
* RESET AND INTERRUPT VECTOR SPECIFICATION 
* BRANCHES FOR EXTERNAL AND INTERNAL INTERRUPTS 


AORG »>0000 
RESET B INIT ; RS- BEGINS PROCESSING HERE. 
* 
INTO B ISRO ; INTO- BEGINS PROCESSING HERE. 
INT1l B ISR1 ; INT1- BEGINS PROCESSING HERE. 
INT2 B ISR2 ; INT2- BEGINS PROCESSING HERE. 
* 
AORG »>0018 
TINT B TIME ; TIMER INTERRUPT PROCESSING. 
RINT B RCV ; SERIAL PORT RECEIVE PROCESSING. 
XINT B XMT ; SERIAL PORT TRANSMIT PROCESSING. 
* 
USER B PROC ; TRAP VECTOR PROCESSING BEGINS. 
* 
* THE BRANCH INSTRUCTION AT PROGRAM MEMORY LOCATION O DIRECTS 
* EXECUTION TO BEGIN HERE FOR RESET PROCESSING THAT INITIALIZES 
* THE PROCESSOR. WHEN RESET IS APPLIED, THE FOLLOWING CONDITIONS 
* ARE ESTABLISHED FOR THE STATUS AND OTHER INTERNAL REGISTERS: 
* 
* ARP OV OVM 1 INTM DP 
* STO: Kas 0 - 1 XXXXXXXXX 
* 
* ARB CNF TC SXM C 11 HM FSM XF FO TXM PM 
* ST1: XXX 0 20°80 4 Bee ha oe eee 
* 
* REGISTER ADDRESS DATA 
*  DRR >0000 XXXKoOXKKX) XEXK -XXKX 
*  DXR >0001 XXXX XXXX XXXX XXXX 
* TIM >0002 He i es Wy es As 
* PRD >0003 5M 0 Be Waa Ws HM 
* IMR >0004 ELE Lill Ligk* xxxx 
* GREG >0005 1111 1111 0000 0000 
* 
* RESERVED XINT RINT TINT INT2 INT1 INTO 
* IMR: 1111111111 X X X X . X 
* 
INIT ROVM ; DISABLE OVERFLOW MODE. 
LDPK 0 ; POINT DP REGISTER TO DATA PAGE 0. 
LARP 7 ; POINT TO AUXILIARY REGISTER 7. 
LACK . >3F ; LOAD ACCUMULATOR WITH >3F. 
SACL 4 ; ENABLE ALL INTERRUPTS VIA IMR. 
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* INTERNAL DATA MEMORY INITIALIZATION. 
* 
ZAC ; ZERO THE ACCUMULATOR. 
LARK  AR7,>60 ; POINT TO BLOCK B2. 
RPTK 31 
SACL *+ ; STORE ZERO IN ALL 32 LOCATIONS. 
* 
LRLK  AR7,>200 ; POINT TO BLOCK BO. 
RPTK 255 
SACL *+ ; ZERO ALL OF PAGE 4. 
RPTK 255 
SACL  *+ : ; ZERO ALL OF PAGE 5. 
* 
* ; POINT TO BLOCK B1. 
RPTK 255 
SACL *+ ; ZERO ALL OF PAGE 6. 
RPTK 255 
SACL  *+ ; ZERO ALL OF PAGE 7. 
* 
* THE PROCESSOR IS INITIALIZED. THE REMAINING APPLICATION- 
* DEPENDENT PART OF THE SYSTEM (BOTH ON- AND OFF-CHIP) SHOULD 
* NOW BE INITIALIZED. 
* 


EINT ; ENABLE ALL INTERRUPTS. 


5.2 Program Control 


To facilitate the TMS320C25’s use in general-purpose high-speed processing, a 
variety of instructions are provided for software stack expansion, subroutine calls, 
timer operation, single-instruction loops, and external branch control. Descriptions 
and examples of how to use these features of the TMS320C25 are given in this 
section. 


5.2.1 Subroutines 


The TMS320C25 has a 16-bit Program Counter (PC) and an eight-level hardware 
stack for PC storage. The CALL and CALA subroutine calls store the current contents 
of the program counter on the top of the stack. The RET (return from subroutine) 
instruction then pops the top of the stack to the program counter. 


Example 5-2 illustrates the use of a subroutine to determine the square root of a 
16-bit number. Processing proceeds in the main routine to the point where the square 
root of a number should be taken. At this point a CALL is made to the subroutine, 
transferring control to that section of the program memory for execution and then 
returning to the calling routine via the RET instruction when execution has 
completed. 


Software Applications 


Example 5-2. Subroutines 


AUTOCORRELATION 


THIS ROUTINE PERFORMS A CORRELATION OF TWO VECTORS AND THEN 


AMPLITUDE OF THE WAVEFORM. 


* 
* 
* 
* CALLS A SQUARE ROOT SUBROUTINE THAT WILL DETERMINE THE RMS 
* 
* 


AUTOC 


LAC 
CALL 
SACL 


+ + + + HF HF 


* 


ENERGY 
SORT 
ENERGY 


SQUARE ROOT 


>60 
>61 
>62 
>63 
>64 


STO 
STl 
0 


1 
NUMBER 
AR1 
AR1,11 
>800 
GUESS 
TEMPR 
ROOT 
NUMBER 
>200 
SQRTLP 
GUESS , 3 
GUESS 
TEMPR 
AR1,14 


* SQUARE ROOT LOOP 


* 


SQRTLP SQRA 
ZALH 


TEMPR 
NUMBER 


NEXTLP 
TEMPR 
ROOT 


=e “ec “se “=e We 


=e “=e “=e Se We We Se Be BVO BVO WO BSE WO WSF We BVO WHE WE WE 


SAVED STATUS REGISTER STO ADDRESS 
SAVED STATUS REGISTER ST1 ADDRESS 
NUMBER X WHOSE SQUARE ROOT IS TAKEN 
INTERMEDIATE ROOTS 

SQUARE ROOT OF X 


SAVE STATUS REGISTER STO. 

SAVE STATUS REGISTER ST1l. 

LOAD DATA PAGE POINTER = 0. 

SET SIGN-EXTENSION MODE. 

LEFT-SHIFT PR OUTPUT TO ACCUMULATOR. 
SAVE X. 


INITIALIZE VARIABLES FOR SQUARE ROOT. 


12 ITERATIONS 

ASSUME X IS LESS THAN >200. 

SET INITIAL GUESS TO >800. 

SET FIRST INTERMEDIATE ROOT TO >800. 
SET SQUARE ROOT VALUE TO O. 

LOAD X INTO THE ACCUMULATOR. 

TEST IF X IS LESS THAN >200. 

IF YES, TAKE THE ROOT; 

IF NO, THEN REINITIALIZE. 

SET INITIAL GUESS TO >4000. 


SET FIRST INTERMEDIATE ROOT TO >4000. 


15 ITERATIONS 


SQUARE TEMPORARY (INTERMEDIATE) ROOT. 


CHECK IF RESULT IS LESS THAN X. 


IF IT'S NOT, SKIP ROOT UPDATE. 
IF IT IS, SET ROOT EQUAL TEMPR. 


THIS SUBROUTINE DETERMINES THE SQUARE ROOT OF A NUMBER X THAT 
IS LOCATED IN THE LOW HALF OF THE ACCUMULATOR WHEN THE ROUTINE 
IS CALLED. THE FRACTIONAL SQUARE ROOT OF X IS TAKEN, WHERE 

O < X < 1 AND WHERE 1 IS REPRESENTED BY >7FFF. THE RESULT IS 
RETURNED TO THE CALLING ROUTINE IN THE ACCUMULATOR. 
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NEXTLP LAC GUESS,15 ; SCALE DOWN GUESS BY 2 TO CONVERGE. 
SACH GUESS 
ADDH ROOT 
SACH TEMPR 
BANZ SQRTLP 


ADD CURRENT ROOT ESTIMATE. 
UPDATE TEMPORARY ROOT VALUE. 
REPEAT SPECIFIED NUMBER OF ITERATIONS. 


=e “oe “=e “Se “oe “oe 


LAC ROOT LOAD THE ROOT OF X. 

weit" “ore RESTORE STATUS REGISTER ST1. 
LST STO RESTORE STATUS REGISTER STO. 
RET 


Hardware stack allocation involves its use in interrupts, subroutine calls, pipelined 
instructions, and the emulator (XDS). The TMS320C25 disables all interrupts when 
taking an interrupt trap. If interrupts are enabled more than one instruction before 
the return of the interrupt service routine, the routine can also be interrupted, thus 
using another level of the hardware stack. This condition should be considered when 
managing the use of the stack. When nesting subroutine calls, each call uses a level 
of the stack. The number of levels used by the interrupt must be remembered as well 
as the depth of the nesting of subroutines. The emulator (XDS) uses one level of 
the stack for breakpoint/single-step operations. Given these constraints, the follow- 
ing listings describe possible allocations of the hardware stack levels: 


level suggested for emulator (XDS) stack 

level reserved for TRAP (software interrupt) instruction 
level reserved for interrupt service routines (ISR) 

levels available for subroutine calls. 


Or: 


- 1 level suggested for emulator (XDS) stack 

- 1 level reserved for TRAP (software interrupt) instruction 
- 2 levels reserved for interrupt service routines (ISR) 

- 4 levels available for subroutine calls. 


When two levels are allocated for ISRs, the individual ISRs can utilize one level of 
subroutine calls or one level of interrupt nesting. 


5.2.2 Software Stack 
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Provisions have been made on the TMS320C25 for extending the hardware stack into 
data memory. This is useful for deep subroutine nesting or stack overflow protection. 


The hardware stack is accessible via the accumulator using the PUSH and POP 
instructions. Two additional instructions, PSHD and POPD, are included in the 
instruction set so that the stack may be directly stored to and recovered from data 
memory. 


A software stack can be implemented by using the POPD instruction at the beginning 
of each subroutine in order to save the PC in data memory. Then before returning, 
a PSHD is used to put the proper value back onto the top of the stack. 


When the stack has seven values stored on it and two or more values are to be put 
on the stack before any other values are popped off, a subroutine that expands the 
stack is needed, such as shown in Example 5-3. In this example, the main program 
stores the stack starting location in memory in AR2 and indicates to the subroutine 
whether to push data from memory onto the stack or pop data from the stack to 
memory. If a ‘0’ is loaded into the accumulator before calling the subroutine, the 
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subroutine pushes data from memory to the stack. If a ‘1’ is loaded into the accu- 
mulator, the subroutine pops data from the stack to memory. 


Since the CALL instruction uses the stack to save the program counter, the subroutine 
pops this value into the accumulator and utilizes the BACC (branch to address 
specified by accumulator) instruction to return to the main program. This prevents 
the program counter from being stored into a memory location. The subroutine in 
Example 5-3 uses the BANZ (branch on auxiliary register not zero) instruction to 
control all of its loops. 


Example 5-3. Software Stack Expansion 


* THIS ROUTINE EXPANDS THE STACK WHILE LETTING THE MAIN 

* PROGRAM DETERMINE WHERE TO STORE THE STACK CONTENTS OR FROM 
* WHERE TO RECOVER THEM. 
* 


USE AR2. 
LOAD COUNTER. 


STACK LARP 2 
LARK AR1,6 


BNZ PO ; IF POPD IS NEEDED, GOTO PO. 
POP ; ELSE, SAVE PROGRAM COUNTER. 
P PSHD *+,ARL ; PUT MEMORY IN STACK. 
BANZ P,*=-,AR2 ; BRANCH TO P UNTIL STACK IS FULL. 
BACC ; RETURN TO MAIN PROGRAM. 
PO POP ; SAVE PROGRAM COUNTER. 
MAR shen ; ALIGN STACK POINTER. 
PO1 POPD *-— ARI ; PUT STACK IN MEMORY. 
BANZ POL) *=,AR2 ; BRANCH TO PO1l UNTIL SAVED. 
MAR ¥+ ; REALIGN STACK POINTER. 
BACC ; RETURN TO MAIN PROGRAM. 


5.2.3 Timer Operation 


The TMS320C25 provides an on-chip timer and its associated interrupt to perform 
various functions at regular time intervals. By programming the period (PRD) register 
from 1 to 65,535 (>FFFF), a timer interrupt (TINT) can be generated every 2 to 
65,536 cycles, respectively. (A period register value of zero is not allowed.) 


Two memory-mapped registers are used to operate the timer. The timer (TIM) 
register, data memory location 2, holds the current count of the timer. At every 
CLKOUT1 cycle, the TIM register is decremented by one. The PRD register, data 
memory location 3, holds the starting count for the timer. When the TIM register 
decrements to zero, a timer interrupt (TINT) is generated. In the following cycle, the 
contents of the PRD register are loaded into the TIM register. In this way, a TINT is 
generated every (PRD + 1) cycles of CLKOUT1. 


The timer and period registers can be read from or written to on any cycle. The count 
can be monitored by reading the TIM register. A new counter period can be written 
to the PRD register without disturbing the current timer count. The timer will then 
start the new period after the current count is complete. If both the PRD and TIM 
registers are loaded with a new period, the timer begins decrementing the new period 
without generating an interrupt. Thus, the programmer has complete control of the 
current and next periods of the timer. 


The TIM and PRD registers are both set to the maximum value on reset (>FFFF). 
The TIM register begins decrementing only after RS is de-asserted. If the timer is 
not used, TINT should be masked. The PRD register can then be used as a gener- 
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al-purpose data memory location. If TINT is used, the PRD and TIM registers should 
be programmed before unmasking the TINT. 


Example 5-4 shows the assembly code that implements the use of the timer to divide 
down the CLKOUTT1 signal. To generate a 9600-Hz clock signal, the PRD register 
should be loaded with 520. In the timer interrupt service routine, the XF line is 
toggled. The XF output is also used as an input for BIO in this example. The output 
of XF will provide a 50-percent duty cycle clock signal as long as the main routine 
or other interrupt routines do not disable interrupts. Interrupts may be disabled by 
direct or implied use of DINT, or by executing instructions in the repeat mode. The 
value for the PRD register is calculated as follows: 


CLKOUT1/(PRD + 1) = 2 x frequency of signal 
10 MHz/(520 + 1) = 2 x 9600 Hz 


Assuming a 10-MHz CLKOUT1 frequency, the frequency of the divided signal is 
9597 Hz. 


Example 5-4. Clock Divider Using Timer 


* SETUP FOR INTERRUPT SERVICE ROUTINE. 
& 


LALK 520 

SACL DMA3 ; LOAD THE PERIOD REGISTER. 
LACK 8 

OR DMA4 

SACL DMA4 ; ENABLE THE TIMER INTERRUPT. 
EINT ; ENABLE INTERRUPTS. 


* I/O SERVICE ROUTINE. 
* 


TIME BIOZ SET1 ; CHECK THE CURRENT XF STATE. 
RXF ; XF WAS HIGH; SET IT LOW. 
EINT ; ENABLE INTERRUPTS. 
RET ; RETURN TO INTERRUPTED CODE. 
SET1 SXF ; XF WAS LOW; SET IT HIGH. 
EINT ; ENABLE INTERRUPTS. 
RET ; RETURN TO INTERRUPTED CODE. 


5.2.4 Single-Instruction Loops 
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When programming time-critical high-computational tasks, it is often necessary to 
repeat the same operation many times. For these cases, repeat instructions that allow 
the execution of the next single instruction N+1 times are provided. N is defined 
by an eight-bit repeat counter (RPTC), which is loaded by the RPT or RPTK 
instructions. The instruction immediately following is then executed, and the RPTC 
is decremented until it reaches zero. 


When using the repeat feature, the instruction being repeated is fetched only once. 
As a result, many multicycle instructions become single-cycle when repeated. This 
is especially useful for |/O instructions, such as TBLR/TBLW, IN/OUT, or 
BLKD/BLKP. 


Since the instruction is fetched and internally latched, the program bus can be used 
to fetch or write a second operand in parallel to operations using the data bus. With 
the instruction latched for repeated execution, the program counter can be loaded 
with a data address and incremented on succeeding executions to fetch data in 
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Example 5-5. 


successive memory locations. As an example, the MAC instruction fetches the 
multiplicand from program memory via the program bus. Simultaneous with the 
program bus fetch, the second multiplicand is fetched from data memory via the data 
bus. In addition to these data fetches, preparation is made for accesses in the 
following cycles by incrementing the program counter and by indexing the auxiliary 
register. TBLR is another example of an instruction that benefits from simultaneous 
transfers of data on both the program and data buses. In this case, data values from 
a table in program memory may be read and transferred to data memory. When 
repeated, the program overhead of reading the instruction from program memory 
must be executed only once, thus allowing the rest of the executions to operate in 
a single cycle. 


Programs, such as those implementing digital filters, require loops that execute in a 
minimum amount of time. Example 5-5 shows the use of the RPT or RPTK 
instructions. 


Instruction Repeating 


* THIS ROUTINE USES THE RPT INSTRUCTION TO SET UP THE LOOP COUNTER 
IN ONE CYCLE. THE FOLLOWING EQUATION IS IMPLEMENTED IN THIS 
ROUTINE: 


* + 


* 

10 

a 

* © we ie oy oD ae 

“ / 

, 

* I-= 1 

* 

* THIS ROUTINE ASSUMES THAT THE X VALUES ARE LOCATED IN ON-CHIP 


* ROM, AND THE Y VALUES IN BLOCK Bl. WHEN REPLACING RPT NUM 
* WITH RPTK 9, THE PROGRAM WILL EXECUTE THE SAME WAY. 
* 


SERIES LARP AR6 


LACK 9 ; SET: COUNTER: TO 9, 

SACL NUM ; (NUM) = 9. 

LRLK AR6,>300 ; POINT AT BEGINNING OF DATA. 

MPYK >0 ; CLEAR P REGISTER. 

ZAC ; CLEAR ACCUMULATOR. 

RPT NUM ; EXECUTE FOLLOWING INSTRUCTION 10 TIMES. 
MAC »>600,*+ ; MULTIPLY AND ACCUMULATE; INCREMENT AR6. 
APAC 

RET ; RETURN TO MAIN PROGRAM. 


5.2.5 Computed GOTOs 


Processing may be executed in a time- and process-dependent or selected way. 
Following a specific time or data processing path may then result in selecting one 
of several processing options. 


A simple computed GOTO can be programmed in the TMS320C25 by using the 
CALA instruction. This instruction uses the contents of the accumulator as the direct 
address of the call. Thus, the call address can be computed in the ALU, as shown 
in Example 5-6. 
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Example 5-6. Computed GOTO 
TASK CONTROLLER 


THIS MAIN TASK ROUTINE CONTROLS THE ORDER OF EXECUTION 

AND SCHEDULING OF TASKS. WHEN AN INTERRUPT OCCURS, THE 
INTERRUPT SERVICE ROUTINE IS EXECUTED TO PROCESS THE INPUT 
AND OUTPUT DATA SAMPLES. AFTER THE INTERRUPT SERVICE 
ROUTINE HAS COMPLETED, THE PROCESSOR BEGINS EXECUTION WITH 
THE INSTRUCTION FOLLOWING THE IDLE INSTRUCTION. THIS 
ROUTINE SELECTS THE TASK APPROPRIATE FOR THE CURRENT 
SAMPLE CYCLE, CALLS THE TASK AS A SUBROUTINE, AND BRANCHES 
BACK TO THE IDLE TO WAIT FOR THE NEXT SAMPLE INTERRUPT 
WHEN THE SCHEDULED TASK HAS COMPLETED EXECUTION. 


ee $e Se FH HH EF HF HS F 


= 
> 
Hi 
be 


IDLE 

LAC SAMPLE 
SUB ONE 
BGEZ  OVRSAM 
LACK °<i5 
OVRSAM SACL SAMPLE 
ADLK  TSKSEQ 
TBLR TEMP 


WAIT FOR SAMPLE INTERRUPT. 

FETCH SAMPLE COUNT VALUE. 
DECREMENT THE SAMPLE COUNT. 

TEST FOR END OF BAUD INTERVAL. 
INIT COUNT FOR NEW BAUD INTERVAL. 
SAVE NEW COUNT VALUE. 

ADD TASK TABLE BASE ADDRESS. 
‘READ SUBROUTINE TASK ADDRESS. 


=e “=e “=e “=e “se “e We Ve “Oe “WO 


LAC TEMP LOAD ACCUMULATOR FOR TASK CALL. 
CALA EXECUTE APPROPRIATE TASK. 
B WAIT 

* 

TSKSEQ EQU $ 


DATA DUMMY 
DATA DUMMY 
DATA DUMMY 
DATA DUMMY 
DATA BDCLK2 
DATA DUMMY 
DATA OUT 

DATA DECODE 


; 15 - UNUSED CYCLE 
DATA DEMODB_ ; 


14 - UNUSED CYCLE 

13 - UNUSED CYCLE 

12 - UNUSED CYCLE 

11 - COMPUTE ENERGY E(11) 

10 - UNUSED CYCLE 

- COMMUNICATE WITH U-CONTROLLER 
- DECODE/GET SCRAMBLED DIBIT 

- DEMODULATE IN MIDDLE OF BAUD 
- UNUSED CYCLE 

UPDATE AGC EVERY 3RD BAUD 

- UNUSED CYCLE 

- COMPUTE ENERGY E(3) 

UNUSED CYCLE 

UNUSED CYCLE 

UNUSED CYCLE 


DATA DUMMY 
DATA AGCUPT 
DATA DUMMY 
DATA BDCLK1 
DATA DUMMY 
DATA DUMMY 
DATA DUMMY 


OrRPNW BH UIOVY~)O WO 
1 
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5.3 Interrupt Service Routine 


Interrupts on the TMS320C25 are prioritized and vectored. When an interrupt occurs, 
the corresponding flag is set in the Interrupt Flag Register (IFR). If the corresponding 
bit in the Interrupt Mask Register (IMR) is set and interrupts are enabled (INTM=0), 
then interrupt processing begins. 


When the interrupt vector is loaded into the program counter, interrupts are disabled 
(INTM=1) and a branch is made to the appropriate routine via the branch instruction 
stored at the associated vector location. Since all interrupts are disabled, interrupt 
processing may proceed without further interruption unless the interrupt service 
routine (ISR) re-enables interrupts. 


Unless the interrupt service routines are simple |/O handlers, the processing in each 
ISR generally must assure that the processor context is preserved during execution. 
The context must be saved before executing the routine itself and restored when the 
routine is finished. A common routine or routines individualized for each interrupt 
may be used to secure the context of the processor during interrupt processing. 
Context switching is also useful for subroutine calls, especially when extensive use 
is made of the stack or auxiliary registers. Code examples of context switching and 
an interrupt service routine are provided in this section. 


5.3.1 Context Switching 


Context switching, commonly required when processing a subroutine call or inter- 
rupt, may be quite extensive or simple, depending on the system requirements. On 
the TMS320C25, the program counter is stored automatically on the hardware stack. 
If there is any important information in the other TMS320C25 registers, such as the 
status or auxiliary registers, these must be saved by software command. A stack in 
data memory, identified by an auxiliary register, is useful for storing the machine state 
when processing interrupts. 


Examples of saving and restoring the state of the TMS320C25 are given in Example 
5-7 and Example 5-8. Auxiliary register 7 (AR7) is used in both examples as the 
stack pointer. As the stack grows, it expands into lower memory addresses. The 
registers saved are the status registers (STO and ST1), accumulator (ACCH and 
ACCL), product register (PR), temporary register (TR), all eight levels of the hardware 
stack, and the auxiliary registers (ARO through AR6). 


The routines in Example 5-7 and Example 5-8 are protected against interrupts, 
allowing context switches to be nested. This is accomplished by the use of the 
MAR *- and MAR “+ instructions at the beginning of the context save and context 
restore routines, respectively. Note that the last instruction of the context save 
decrements AR7 while the context restore is completed with an additional increment 
of AR7. This prevents the loss of data if a context save or restore routine is interrupted. 
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Example 5-7. Context Save 


* + + Bt 


CET 
DEF 


"CONTEXT SAVE' 


SAVE 


CONTEXT SAVE ON SUBROUTINE CALL OR INTERRUPT. 


ASSUME AR7 IS THE STACK POINTER AND AR7 


SAVE LARP 


* 
* 


+ 


+ * * + +H HF HF F 


MAR 


AR7 


Te 


e 
, 


° 
’ 


(ARP) --> ARB, 7 --> ARP, 


SAVE THE STATUS REGISTERS. 


SST1 
SST 


SAVE THE 
SACH 
SACL 


SAVE THE 
SPM 
SPH 
SPL 


SAVE THE 
MPYK 
SPL 


: 
* a 


Ie 
* om 


0 


a 
, ee 


i 


* = 


e 
4 


e 
/ 


ACCUMULATOR. 


* 
f 


° 
/ 


P REGISTER. 
T REGISTER. 


° 
/ 


* 
/ 


rt 
STO 


--> Claes? , 
--> (1761, 


ACCH -=> (125), 
ACCL--> (124), 


128. 


NO SHIFT ON PR OUTPUT 
PRH --> (123), 
PRL --> (122), 


PR 
TR 


= TR 


--> (i254, 


SAVE ALL EIGHT LEVELS OF THE HARDWARE STACK. 


RPTK 
POPD 


r; 


XK 


=e “=2e =e Wwe =e “se =e ™e 


TOS 


(8) --> L2G, 
STACK( 7) ‘==> (119); 
STACK(6) ==>°( 118), 


STACK(4) -=-> 
STACK(3) -=-> 
STACK(2) <--> 


BOS 


SAVE AUXILIARY REGISTERS 


SAR 
SAR 
SAR 
SAR 
SAR 
SAR 
SAR 


ARO, *- 
AR1,*- 
AR2,*- 
AR3,*- 
AR4,*- 
AR5,*- 
AR6,*- 


SAVE IS COMPLETE. 


/ 
/ 
/ 
, 
Ld 
/ 
i 


ARO 
ARO 
ARO 
ARO 
ARO 
ARO 
ARO 


( 
( 
( 
SDACK(S) aie ofhb7):, 
( 
( 
( 
( 


Dat 


ARO THROUGH AR6. 


--> C22) r 
--> €31 3) 7 
--> (110) , 
syeeee eet BAR 
me CLUBS TY 
==> (107) |, 
--> (106) td 


AR7 
AR7 


AR7 
AR7 


AR7 
AR7 


AR7 
AR7 


AR7 


AR7 
AR7 
AR7 
AR7 
AR7 
AR7 
AR7 
AR7 


AR7 
AR7 
AR7 
AR7 
AR7 
AR7 
AR7 


128 
127 


126 
bbe 


124 
123 


Led 
ed. 


120 


Software Applications 


Example 5-8. Context Restore 


TITL "CONTEXT RESTORE' 
DEF RESTOR 
* 
* CONTEXT RESTORE AT THE END OF A SUBROUTINE OR INTERRUPT. 
* 
* ASSUME AR7 IS THE STACK POINTER AND AR7 = 105. 
* 
RESTOR LARP AR7 ; (ARP) --> ARB, 7 --> ARP, AR7 = 
MAR *+ ; AR7 = 
* 
* RESTORE AUXILIARY REGISTERS ARO THROUGH AR6. 
LAR AR6, *+ ; (106) --> ARG, AR7. = 
LAR AR5,*+ ; (107) --> ARS, AR? = 
LAR AR4,*+ > (108) --> AR4, AR]. = 
LAR AR3,*+ ; (109) --> AR3, AR? = 
LAR AR2,*+ ; (110) --> AR2, AR} = 
LAR AR1,*+ ; (111) --> ARI, AR7 = 
LAR ARO, *+ (112) -->_ ARO, AR7 = 
* 
* RESTORE ALL EIGHT LEVELS OF THE HARDWARE STACK. 
RPTK 7 
PSHD x4 s (413) -=>5B0S’ (1); AR] = 
; (114) --> STACK(2), AR7 = 
; (115) --> STACK(3), AR7 = 
; (116) --> STACK(4), AR7 = 
; (117) --> STACK(5), AR] = 
; (118) --> STACK(6), AR7 = 
; (119) --> STACK(7), ART = 
; (120) --> TOS (8), AR7 = 


+ + + + + He FH HF He He HF HF HF F 


THE RETURN PC IS NOW ON THE TOP OF THE STACK FOR THE 
RET INSTRUCTION. NOTE THAT THE LOWER 16 BITS OF THE 

P REGISTER MUST BE LOADED VIA THE T REGISTER AND THAT 
THE STACK POINTER IS POINTING AT THE VALUE TO BE LOADED 
IN THE T REGISTER. 


RESTORE THE LOW P REGISTER. 


MAR * + ; SKIP T REGISTER, AR7 = 
LT ee > (122) --> TR, AR7 = 
MPYK iL. ; (TR) --> PRL 
RESTORE THE T REGISTER. 
LT * + 7 °(121) --> TR, AR7 = 
MAR e+ ; SKIP P REGISTER LOW, AR7 = 
LPH *+ > (123) --> PRH, AR7 = 
RESTORE THE ACCUMULATOR. 
ZALS *+ : (124) --> ACCL, AR7 = 
ADDH *+ » (125) --> ACCH, AR7 = 
RESTORE THE STATUS REGISTERS. 
LST e+ ; (326) => STO, AR7 = 
LST1 + ¢ 227) => Sti, AR7 = 
RESTORE IS COMPLETE. 
EINT ; ENABLE INTERRUPTS. 
RET ; RETURN TO INTERRUPTS OR 


; CALLING ROUTINE. 


105 
106 


107 
108 
109 
110 
co ae! 
i Be 
113 


114 
Saket 
116 
Ae 
118 
L139 
120 
Lad 


Lee 
tel 


pee 
Les 


124 


Le 
126 


127 
128 
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5.3.2 Interrupt Priority 


Example 5-9. 


5-14 


Interrupts on the TMS320C25 are prioritized in hardware. This allows interrupts that 
occur simultaneously to be serviced in a prioritized order. Sometimes priority may 
be determined by frequency or rate of occurrence. An infrequent, but lengthy, inter- 
rupt service routine (ISR) might need to be interrupted by a more frequently occurring 
interrupt. In the routine of Example 5-9, the ISR for INT1 temporarily modifies the 
interrupt mask register (IMR) to permit interrupt processing when an interrupt on 
INTO (but no other interrupt) occurs. When the routine has finished processing, the 


IMR is restored to Its original state. 


Interrupt Service Routine 


y iat By i "INTERRUPT SERVICE ROUTINE' 


DEF ISR1 


) REF IMR 
* 
* INTERRUPT PROCESSING FOR EXTERNAL INTERRUPT INT1-. 
* 
* THIS ROUTINE MAY BE INTERRUPTED BY AN INTERRUPT FROM THE 
* EXTERNAL INTERRUPT INTO-, BUT NO OTHER. 
* 
ISR1 LARP ART ; 7 --> ARP 
MAR *- ART 
SST1  *- ; ST1 --> *AR7, AR7 
SST ¥- ; STO --> *AR7, ART 
SACH *- ; ACCH --> *AR7, AR7 
SACL *- ; ACCL --> *AR7, ART 
LDPK 0 ; DP = 0 
PSHD IMR ; IMR --> TOS 
LACK >0001 ; MASK FOR INTO- 
AND IMR ; MASK CURRENT IMR CONTENTS. 
SACL IMR ; ACC --> IMR 
EINT ; ENABLE INTERRUPTS. 


* MAIN PROCESSING SECTION FOR ISR1. 


DINT ; DISABLE INTERRUPTS. 
LDPK 8) ; DP = 0 

POPD IMR 7 70s. ~=2 . Dee 

LARP AR7 y |] ==> - ARP 

MAR le ; AR7 
ZALS "+ + SAR]. —-=> ACCL; ARI 
ADDH w+ ¢. RRR]. ~=>,. ROCHE ». Ams 
LST be > SAR? =-27. 570, ...Are 
LST1 t+ 3s "ART =") STL, Aki 
EINT ; ENABLE INTERRUPTS. 
RET 


AR7 
AR7 
AR7 
AR7 
AR7 


AR7 
AR7 
AR7 
AR7 
AR7 


+++++ 
PRPREPR 


PRRRPPR 


Software Applications 


5.4 Memory Management 


The structure of the TMS320C25’'s memory map is programmable and can vary for 
each application. Instructions are provided for moving blocks of data or program 
memory, configuring a block of on-chip data RAM as program memory, and defining 
part of external data memory as global. Explanations and examples of moving, 
configuring, and manipulating memory are provided in this section. 


5.4.1 Block Moves 


Since the TMS320C25 directly addresses a large amount of memory, blocks of data 
Or program code can be stored off-chip in slow memories and then loaded on-chip 
for faster execution. Data can also be moved from on-chip to off-chip for storage 
or for multiprocessor data transfers. 


The BLKD and BLKP instructions facilitate memory-to-memory block moves on the 
TMS320C25. The BLKD instruction moves a block within data memory as shown 
in Example 5-10. Data may also be transferred between data memory and program 
memory by means of the TBLR and TBLW instructions. The instructions IN and OUT 
are used to transfer data between the data memory and the I/O space. 


Example 5-10. Moving External Data Memory to Internal Data Memory with BLKD 


+ 


THIS ROUTINE USES THE BLKD INSTRUCTION TO MOVE A BLOCK OF 
EXTERNAL DATA MEMORY (DATA PAGES 8 AND 9) TO INTERNAL BLOCK 
Bl (DATA PAGES 6 AND 7). 


+ + + 


MOVED LARP AR2 


LRLK AR2,>300 DESTINATION IS BLOCK Bl IN RAM. 


Res. £8 ; REPEAT NEXT INSTRUCTION 256 TIMES. 
BLKD >400, *+ ; MOVE EXTERNAL BLOCK TO BLOCK Bl. 
RET ; RETURN TO MAIN PROGRAM. 


For systems that have external program memory but no external data memory, BLKP 
can be used to move program memory blocks into data memory. Example 5-11 
demonstrates how to use the BLKP instruction. 


Example 5-11. Moving Program Memory to Data Memory with BLKP 


THIS ROUTINE USES THE BLKP INSTRUCTION TO MOVE DATA VALUES 
FROM PROGRAM MEMORY INTO DATA MEMORY. SPECIFICALLY, THE 
VALUES IN LOCATIONS 2, 3, 4, AND 5 IN PROGRAM MEMORY ARE 
MOVED TO LOCATIONS 512, 513, 514, AND 515 IN DATA MEMORY. 


+ + + + 


MOVEP LARP AR2 
LRLK AR2,512 


SET REFERENCE FOR INDIRECT ADDRESSING. 
LOAD BEGINNING OF BLOCK BO IN AR2. 


=e “™e “Se Se “SE 


RPTK 3 SET UP LOOP. 
BLKP > 2, + PUT DATA INTO DATA RAM. 
RET RETURN TO MAIN PROGRAM. 


Another method for transferring data from program memory into data memory makes 
use of the TBLR instruction. By using the TBLR instruction, a calculated, rather than 
predetermined, location of a block of data in program memory may be specified for 
transfer. A routine using this approach is shown in Example 5-12. 
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Example 5-12. Moving Program Memory to Data Memory with TBLR 


THIS ROUTINE USES THE TBLR INSTRUCTION TO MOVE DATA VALUES 
FROM PROGRAM MEMORY INTO DATA MEMORY. BY USING THIS ROUTINE, 
THE PROGRAM MEMORY LOCATION IN THE ACCUMULATOR FROM WHICH 
DATA IS TO BE MOVED TO A SPECIFIC DATA MEMORY LOCATION CAN 
BE SPECIFIED. ASSUME THAT THE ACCUMULATOR CONTAINS THE 
ADDRESS IN PROGRAM MEMORY FROM WHICH TO TRANSFER THE DATA. 


te He HS UH: eS 


TABLER LARP AR5 


LRLK AR5,380 DESTINATION ADDRESS = PAGE 7. 


RPTK 127 ; TRANSFER 128 VALUES. 
TBLR + ; MOVE DATA INTO DATA RAM. 
RET ; RETURN TO CALLING PROGRAM. 


In cases where systems require that temporary storage be allocated in the program 
memory, TBLW can be used to transfer data from internal data memory to external 
program memory. The code in Example 5-13 demonstrates how this may be 
accomplished. 


Example 5-13. Moving Internal Data Memory to Program Memory with TBLW 


THIS ROUTINE USES THE TBLW INSTRUCTION TO MOVE DATA VALUES 
FROM INTERNAL DATA MEMORY TO EXTERNAL PROGRAM MEMORY. THE 
CALLING ROUTINE MUST SPECIFY THE DESTINATION PROGRAM MEMORY 
ADDRESS IN THE ACCUMULATOR. ASSUME THAT THE ACCUMULATOR 
CONTAINS THE ADDRESS IN PROGRAM MEMORY INTO WHICH THE DATA 
IS TRANSFERRED. 


+ + ee HF HF F 


TABLEW LARP ARO 


LRLK AR6,380 SOURCE ADDRESS = PAGE 7. 


RPTK Let ; TRANSFER 128 VALUES. 
TBLW Rt ; MOVE DATA TO EXTERNAL PROGRAM RAM. 
RET ; RETURN TO CALLING PROGRAM. 


The IN and OUT instructions are used to transfer data between the data memory and 
the |/O space, as shown in Example 5-14 and Example 5-15. 


Example 5-14. Moving Data from I/O Space into Data Memory with IN 


THIS ROUTINE USES THE IN INSTRUCTION TO MOVE DATA VALUES 
FROM THE I/O SPACE INTO DATA MEMORY. DATA ACCESSED FROM 
I/O PORT 15 IS TRANSFERRED TO SUCCESSIVE MEMORY LOCATIONS 
ON DATA PAGE 5. 


+ + % 


INPUT LARP AR2 


LRLK AR2,>2C0 DESTINATION ADDRESS = PAGE 5. 


RPTK 63 ; TRANSFER 64 VALUES. 
IN PALS (4+ ; MOVE DATA INTO DATA RAM. 
RET ; RETURN TO CALLING PROGRAM. 
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Example 5-15. Moving Data from Data Memory to I/O Space with OUT 


* THIS ROUTINE USES THE OUT INSTRUCTION TO MOVE DATA VALUES 
* FROM THE DATA MEMORY TO THE I/O SPACE. DATA IS TRANSFERRED 
TO I/O PORT 8 FROM SUCCESSIVE MEMORY LOCATIONS ON DATA 
PAGE 4. 


+ + 


OUTPUT LARP AR4 


LRLK AR4,>200 SOURCE ADDRESS = PAGE 4. 


RPTK 63 ; TRANSFER 64 VALUES. 
OUT PAS , *+ ; MOVE DATA FROM DATA RAM. 
RET ; RETURN TO CALLING PROGRAM. 


5.4.2 Configuring On-Chip RAM 


The large amount of external memory and the configurability of on-chip RAM simplify 
the downloading of data or program memory into the TMS320C25. Also, since data 
in the RAM is preserved when redefining on-chip RAM, block BO can be configured 
dynamically as either data or program memory. Figure 5-1 illustrates the changes in 
on-chip RAM when switching configurations. 
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PROGRAM DATA MEMORY 
BUS BUS LOCATIONS 


DATA 0-5 
(>0000->0005) 
DATA 96-127 


(>0060->007F) 


DATA 512-767 
(>0200->02FF) 


DATA 768-1023 
(>0300->03FF) 


PROGRAM DATA 
BUS 


MEMORY 
LOCATIONS 


DATA 0-5 
(>0000->0005) 


PROGRAM 65,280-65,535 
(>FFOO->FFFF) 


DATA 96-127 
ba dic a (>0060->007F) 


DATA 768-1023 
eet (>0300->03FF) 


Figure 5-1. On-Chip RAM Configurations 


On-chip memory is configured by a reset or by the CNFD and CNFP instructions. 
Block BO is configured as data memory by executing CNFD or reset. A CNFP 
instruction configures block BO as program memory. 


Configuring block BO as program memory is useful for implementing adaptive filters 
or other similar applications at full speed with only on-chip memories. Example 5-16 
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illustrates the use of the configuration modes to utilize block BO as data and program 
memory while executing from on-chip program ROM. 


git fg 
DEF 
DEF 


* 
* 
* 
* 
* 
* 
COEFFP EQU 
COEFFD EQU 
* 
ONE EQU 
BETA EQU 
ERR EQU 
ERRF  EOQU 
4 EQU 
Xx EQU 
FRSTAP EQU 


LASTAP EQU 
* 


Example 5-16. Configuring and Using On-Chip RAM 


"ADAPTIVE FILTER' 


ADPFIR 
X,Y 


>FFOO 
>0200 


>7A 
>7B 
AIC 
>7D 
PTE 
>7F 
>0380 
Z203FF 


=e ee Se “=e “Se “se B6 BO 


THIS 128-TAP ADAPTIVE FIR FILTER USES ON-CHIP MEMORY BLOCK 
BO FOR COEFFICIENTS AND BLOCK Bl FOR DATA SAMPLES. THE 
NEWEST INPUT SHOULD BE IN MEMORY LOCATION X WHEN CALLED. 
THE OUTPUT WILL BE IN MEMORY LOCATION Y WHEN RETURNED. 


BO PROGRAM MEMORY ADDRESS 
BO DATA MEMORY ADDRESS 


CONSTANT ONE (DP=6) 
ADAPTATION CONSTANT (DP=6) 


SIGNAL ERROR (DP=6) 
ERROR FUNCTION (DP=6) 
FILTER OUTPUT (DP=6) 
NEWEST DATA SAMPLE  (DP=6) 


NEXT NEWEST DATA SAMPLE 
OLDEST DATA SAMPLE 


* FINITE IMPULSE RESPONSE (FIR) FILTER. 


* 


ADPFIR CNFP 


FIR 


+ 


MPYK 
LAC 

LARP 
LRLK 
RPTK 
MACD 
CNFD 
APAC 
SACH 
NEG 

ADD 

SACH 


LT 
MPY 
PAC 
ADD 
SACH 


LARP 
LARK 
LRLK 
LRLK 
DMOV 
LT 
MPY 


0 

ONE ,14 

AR3 
AR3,LASTAP 
127 
COEFFP, *- 


tp 


X, 15 
ERR,1 


ERR 
BETA 


ONE,14 
ERRF,1 


AR3 
AR1,127 
AR2 ,COEFFD 
AR3,LASTAP 
X 

ERRF 

*-  AR2 


e 
’ 


=e “=e =e “Se 


CONFIGURE BO AS PROGRAM: 
Clear the P register. 

Load output rounding bit. 
Point to the oldest sample. 


128-tap FIR filter. 
CONFIGURE BO AS DATA: 


Store the filter output. 


Add the newest input. 
err(n) = x(n) - y(n) 


LMS ADAPTATION OF FILTER COEFFICIENTS. 


128-TAP FIR FILTER. 
errf(n) = beta * err(n) 
ROUND THE RESULT. 


128 COEFFICIENTS TO UPDATE. 
POINT TO THE COEFFICIENTS. 
POINT TO THE DATA SAMPLES. 
INCLUDE NEWEST SAMPLE. 


P = 2*beta*err(n)*x(n-k) 
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ADAPT ZALR *,AR3 ; LOAD ACCH WITH ak(n) & ROUND. 
MPYA *-,AR2 ; ak(n+1) = ak(n) + P 

* ; P = 2*beta*err(n)*x(n-k) 
SACH *+,0,AR1 ; STORE ak(nt+1). 
BANZ ADAPT,*-,AR2 ; END OF LOOP TEST. 


RET ; RETURN TO CALLING ROUTINE. 


5.4.3 Using On-Chip RAM for Program Execution 
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In using on-chip memory (block BO) for program execution, this memory must first 
be loaded with executable code from external memories while configured as data 
memory. On-chip execution is initiated by using the CNFP instruction to reconfigure 
block BO as program memory and performing a branch or call to an on-chip RAM 
address. By configuring block BO as program memory and executing from this 
internal memory, full-speed execution can be achieved in systems using slower 
external memory. Example 5-17 illustrates how a program may be written to be 
loaded into and executed from on-chip memory. 


One group of instructions, the branch/call instructions, are impacted by the location 
of execution. Normally, by using labels, the assembler properly determines the 
location to which a branch is taken. Since the code is relocated prior to execution 
from on-chip memory, it is necessary to alter the address determined by the assembler 
for branch instructions. This alteration is necessary so that the branch address that 
is determined can be consistent with the address space used during execution. In 
Example 5-17, this is accomplished by adding an offset value (OFFSET) to the 
branch label representing the destination address in the operand field for each branch 
instruction. The offset address is determined by use of an EQU (equate) directive 
that subtracts the assembler location of the code to be relocated (equivalent to base-0 
addressing) from the base address of the relocation address (internal block BO 
address in this case). 
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Example 5-17. Program Execution from On-Chip Memory 


AORG 0 
RESET B INIT 
* 
* BRANCHES FOR EXTERNAL OR INTERNAL INTERRUPTS FOLLOW HERE AT 
* THE DESIGNATED LOCATIONS AS REQUIRED. 
* 


AORG >20 


A BRANCH INSTRUCTION AT PROGRAM MEMORY LOCATION O DIRECTS 
PROCESSOR EXECUTION HERE. 


INITIALIZE THE PROCESSOR. 


+ £¢ SF EF HS F 


INIT ROVM DISABLE OVERFLOW MODE. 


SSXM SET SIGN EXTENSION. 

LDPK O POINT DP REGISTER TO DATA MEMORY PAGE 0. 
SPM 0 NO SHIFT ON PRODUCT REGISTER OUTPUT. 
LARP AR4 USE AUXILIARY REGISTER 4 (SET ARP = 4). 


POINT AR4 TO PERIOD REGISTER. 
SET ACCUMULATOR TO >FFFF. 


LARK AR4,PRD 
LALK OFFFF 


=e “=e “Se Se W068 @6e We BW B06 WS WE 


SACL -*+ LOAD PERIOD REGISTER WITH MAXIMUM VALUE. 
SACL °*+ ENABLE ALL INTERRUPTS VIA IMR. 

ZAC CLEAR ACCUMULATOR. 

SACH * CLEAR GREG TO MAKE ALL MEMORY LOCAL. 


* 


* LOAD TIME-CRITICAL CODE FROM EXTERNAL SLOW MEMORY TO INTERNAL RAM. 
* 

USE AUXILIARY REGISTER 1 (SET ARP = 1). 
POINT AR1 TO RECONFIGURABLE BLOCK BO. 

LOAD REPEAT COUNTER WITH BLOCK LENGTH. 
MOVE CODE FROM PROG MEMORY TO ON-CHIP RAM. 


LARP AR1 

LRLK AR1,BLKO 
RPTK PROGL-1 
BLKP PROG, *+ 


=e ™=e =e =e 


* 


INITIALIZE PARAMETERS FOR EXECUTION. 


LDPK 6 POINT DP REGISTER TO DATA MEMORY PAGE 6. 
LACK 1 SET ACCUMULATOR TO >0OO00O1. 
SACL ONE STORE VALUE OF 1. 


POINT AR1 TO INTERNAL MEMORY ADDRESS. 
LOAD REPEAT COUNTER WITH BLOCK LENGTH. 
MOVE DATA FROM PROG MEMORY TO ON-CHIP RAM. 


LRLK AR1,BLKO+PRGL 
RPTK COEFL-1 
BLKP COEF, *+ 


CNFP CONFIGURE BLOCK BO AS PROGRAM MEMORY. 
LALK >FFOO LOAD ACC WITH PROG ADDR IN INTERNAL RAM. 
BACC BRANCH TO ON-CHIP EXECUTION ADDRESS. 


=e “se “Se “=e “We “es “Se “8 SE 
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* 


* SIGNAL PROCESSING CODE TO BE EXECUTED FROM ON-CHIP RAM. 


* 


PROG 
LPTS 


GET 


PROGE 
PROGL 


OFFSET EQU 
* 


$ 

GET+OFFSET 
LPTS+OFFSET 
FILOUT, PA2 
FILIN, PA2 
AR1,BLK1+SIGNAL 


0 
i 
>FFOO+COEFF , *- 


FILOUT,1 
LPTS+OFFSET 
$ 
PROGE-PROG : 
>FFOO-PROG : 


=e “se “Se “se “se Se “=e “6s We “6 Ve We 


WAIT FOR INPUT SIGNAL. 
BRANCH IF NO SIGNAL. 
OUTPUT LAST FILTER OUTPUT. 
INPUT NEW SIGNAL SAMPLE. 
POINT AR1 TO SIGNAL DATA TO PROCESS. 
CLEAR THE ACCUMULATOR. 
CLEAR THE P REGISTER. 
REPEAT MACD INSTRUCTION FOR 16 TAPS. 
MULTIPLY/ACCUMULATE, SAMPLE DELAY. 
ACCUMULATE THE LAST PRODUCT. 

SAVE THE RESULT. 

LOOP TO WAIT FOR NEXT SAMPLE. 


PROGRAM CODE LENGTH. 
BASE ADDRESS OFFSET. 


* COEFFICIENT DATA TO BE LOADED INTO ON-CHIP RAM. 


« 
COEF 


COEFE 
COEFL 


* 


DATA 
DATA 
DATA 
DATA 
EQU 
EQU 


385 ,-1196,1839,-2009 
1390,407,-4403,19958 
19958 ,-4403,407,1390 
-2009,1839,-1196;,385 


$ 
COEFE-COEF ; 


* INTERNAL MEMORY CONSTANTS. 


* 


BLKO 


BLK1 
« 


* DATA 
* 


DRR 
DXR 
TIM 
PRD 
IMR 


BO 


COEFF 


* 


* DATA 


* 


ONE 


FILOUT 
FILIN 
SIGNAL 


EQU 
EQU 


PAGE 


PAGE 


DORG 
BSS 
BSS 
BSS 
BES 
END 


>200 
>300 


O (BLOCK B2) 


PRRPRPRRrO 
~~ ~ ”- ~~ ~ ~~ 


4 (BLOCK BO) 
0 

PROGL ; 
COEFL : 


6 (BLOCK B1) 


PRR O 


=e se “Se We 


COEFFICIENT DATA LENGTH. 


- DATA MEMORY LABELS. 


SERIAL PORT DATA RECEIVE REGISTER. 

SERIAL PORT DATA TRANSMIT REGISTER. 
TIMER REGISTER. 

PERIOD REGISTER. 

INTERRUPT MASK REGISTER. 

GLOBAL MEMORY ALLOCATION REGISTER. 


- DATA MEMORY LABELS. 


LOCATIONS FOR INTERNAL PROGRAM CODE. 
LOCATIONS FOR COEFFICIENT MEMORY. 


- DATA MEMORY LABELS. 


RESERVED FOR DATA VALUE OF 1. 
FILTER OUTPUT SIGNAL VALUE. 
FILTER INPUT SIGNAL VALUE. 
LAST SIGNAL DELAY VALUE. 
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5.5 Fundamental Logical and Arithmetic Operations 


Although the TMS320C25 instruction set is oriented toward digital signal processing, 
the same fundamental operations of a general-purpose processor are included. This 
section explains basic operations of the TMS320C25’s Central Arithmetic Logic Unit 
(CALU), particularly accumulator operations, the status register effect on data 
processing, and bit manipulation. 


The TMS320C25 provides a complete set of logical operations, including AND, OR, 
XOR, and CMPL (complement) instructions. This enables the device to perform any 
logical function. These instructions may be used to perform sign magnitude to two’s 
complement or the reverse conversions. 


The contents of the accumulator may be stored in data memory using the SACH and 
SACL instructions or stored in the stack by using the PUSH instruction. The accu- 
mulator may be loaded from data memory using the ZALH and ZALS instructions, 
which zero the accumulator before loading the data value. The ZAC instruction zeroes 
the accumulator. POP can be used to restore the accumulator contents from the 
stack. 


The accumulator is also affected by the ABS and NEG instructions. ABS replaces 
the contents of the accumulator with the absolute value of its contents. NEG 
generates the arithmetic complement of the accumulator in two’s-complement form. 


5.5.1 Status Register Effect on Data Processing 


Three data processing options allow the ALU to automatically suppress sign exten- 
sion, manage overflow, or scale product accumulations. These options are enabled 
or disabled through bits in the status registers. These options function in parallel 
with normal execution of the instructions and cause no additional machine cycles, 
therefore no performance overhead. 


The sign-extension mode option is used to determine whether or not the shifted data 
values fetched for ALU operations should be sign-extended. The SXM status bit 
controls this operation. This bit is set to ‘1’ for enabling sign extension using the 
SSXM instruction, and set to ‘0’ for suppressing sign extension using the RSXM 
instruction. This operation affects all the instructions that include a shift of the 
incoming data value (i.e. ADD, ADDT, ADLK, LAC, LACT, LALK, SBLK, SFR, SUB, 
and SUBT). 


The overflow mode option is used to minimize the effects of an arithmetic overflow 
by forcing the accumulator to saturate at the largest positive value (or in the case 
of underflow, the largest negative value). The OVM status bit controls this operation. 
The overflow mode is enabled by setting the OVM bit to a ‘1’ using the SOVM 
instruction, and reset using the ROVM instruction. This feature affects all arithmetic 
operations in the ALU. 


The product register shift mode option forces all products to be shifted before they 
are accumulated. The products can be left-shifted one bit to delete the extra sign 
bit in the multiply of two 16-bit signed numbers. The products can be left-shifted 
four bits to delete the extra sign bits in multiplying a 16-bit data value by a 13-bit 
constant. The product shifter can also be used to shift all products six bits to the right 
to allow up to 128 product accumulations without the threat of an arithmetic over- 
flow, thereby avoiding the overhead of overflow management. The shifter can be 
disabled to cause no shift in the product when working with integer or 32-bit 
precision operations. This also maintains compatibility with TMS32010 code. These 
operations are controlled by the value contained in the PM bits of status register ST1. 
The PM bits are set using the SPM instruction. This feature affects all the instructions 
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that use the product of the multiplier (i.e, APAC, LTA, LTD, LTP, LTS, MAC, MACD, 
MPYA, MPYS, PAC, SPAC, SPH, SPL, SQRA, and SQRS). 


5.5.2 Bit Manipulation 


The BIT instruction tests any of the 16 bits of the addressed data word. The specified 
bit is copied into the TC of the status register. The bit tested is specified by a bit 
code in the opcode of the instruction. Either the BBZ (branch on TC bit = 0) or 
BBNZ (branch on TC bit = 1) instructions check the bit and allow branching to a 
service routine. 


Bit testing is useful in control applications where a number of states or conditions 
may be latched externally and read into the TMS320C25 via an IN instruction. At this 
point, individual bits can be tested and branches taken for appropriate processing. 


Since the BIT instruction requires the bit code to be specified with the instruction, 
it cannot be placed in a loop to test several different bits of a data word or bits 
determined by prior processing for efficient use. The TMS320C25 also has a BITT 
instruction in which the bit code is specified in the T register. Since the T register 
can easily be modified, BITT may be used to test all bits of a data word if placed 
within a loop or to test a bit location determined by past processing. 


Example 5-18. Using BIT and BBZ 


* THIS ROUTINE USES THE BIT INSTRUCTION TO TEST THE CONDITION 
* OF AN EXTERNAL MUX. BIT 4 DETERMINES THE UTILITY OF THE 

* REMAINING DATA. IF ZERO, A COUNTER IS INCREMENTED. IF ONE, 
* ADDITIONAL PROCESSING OCCURS AND THE COUNTER IS CLEARED. 

* THE ROUTINE IS INVOKED WHENEVER A TIMER INTERRUPT OCCURS. 

* 


TIME SST STO ; SAVE STATUS REGISTER STO. 
LDPK 0 
LARP AR6 
IN DAT ,PA8 ; READ IN VALUE. 
BIT DAT ,>B ; TEST BIT 4. 


BBZ INCR ; BRANCH AND INCREMENT IF POSITIVE. 


LARK AR6,0 CLEAR THE COUNTER. 


LST STO ; RELOAD THE STATUS REGISTER. 
EINT ; ENABLE INTERRUPTS. 
RET ; RETURN TO INTERRUPTED ROUTINE. 
# 
INCR MAR e+ ; INCREMENT THE COUNTER. 
LST STO ; RELOAD THE STATUS REGISTER. 
EINT ; ENABLE INTERRUPTS. 
RET ; RETURN TO INTERRUPTED ROUTINE. 
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Example 5-19. Using BITT and BBNZ 


* THIS ROUTINE USES THE BITT INSTRUCTION TO TEST THE CONDITION 
* OF AN EXTERNAL MUX. A BIT IN THE MUX IS SIGNIFICANT ONLY 
* WHEN PRIOR PROCESSING HAS DESIGNATED THE BIT TO BE ACTIVE. 
* INDIVIDUAL PROCESSING WILL TAKE PLACE BASED UPON THE STATE 
* OF THE TESTED BIT. THE BITS ARE TESTED EACH TIME A TIMER 
* INTERRUPT OCCURS. 
* 
TIME SST STO ; SAVE STATUS REGISTER STO. 

LDPK 0 

LARP AR5 

LAR AR5,BCNT ; LOAD COUNT OF ACTIVE BITS. 

LRLK AR6,BTBL ; LOAD THE BIT TABLE ADDRESS. 

IN DAT,PA8 ; READ IN VALUE. 

B LTEST,*-,6 
TMLOOP LT #45 ; LOAD BIT CODE. 

BITT DAT ; TEST SPECIFIED BIT. 


BBNZ LTEST ; BRANCH IF BIT IS ONE. 


LTEST BANZ TMLOOP,*-,6 


LST STO ; RELOAD THE STATUS REGISTER. 
EINT ; ENABLE INTERRUPTS. 
RET ; RETURN TO INTERRUPTED ROUTINE. 


5.6 Advanced Arithmetic Operations 


The TMS320C25 provides special instructions that facilitate efficient execution of 
arithmetic-intensive DSP algorithms, such as MACD, SQRA, SUBC, and NORM. 
Explanations and examples of how to use these instructions with overflow 
management, and for data moves, multiplications, division, floating-point arithmetic, 
indexed addressing, and extended-precision arithmetic are included in this section. 


5.6.1 Overflow Management 


The TMS320C25 has four features that can be used to handle overflow management. 
These include the branch on overflow conditions, accumulator saturation (overflow 
mode), product register right shift, and accumulator right shift. These features provide 
several options for overflow protection within an algorithm. 


A program can branch to an error handler routine on an overflow of the accumulator 
by using the BV (branch on overflow) instruction or bypass an error handler by using 
the BNV (branch if no overflow) instruction. These instructions can be performed 
after any ALU operation that may cause an accumulator overflow. 


The overflow mode is a feature useful for DSP applications. This mode simulates the 
saturation effect characteristic of analog systems. When enabled, any overflow in 
the accumulator results in the accumulator contents being replaced with the largest 
positive value (>7FFFFFFF) if the overflowed number is positive, or the largest 
negative value (>80000000) if negative. The overflow mode is controlled by the 
OVM bit of status register STO and can be changed by the SOVM (set overflow 
mode), ROVM (reset overflow mode), or LST (load status register) instructions. 
Overflows can be detected in software by testing the OV (overflow) bit in status 
register STO. When a branch is used to test the overflow bit, OV is automatically reset. 
Note that the OV bit does not function as a carry bit. It is set only when the absolute 
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5.6.2 Scaling 


value of a number is too large to be represented in the accumulator, and it is not reset 
except by specific instructions. 


Another method of overflow management, which applies to multiply-accumulate 
operations, is the use of the right shifter of the product register. The right shifter, 
which operates with no cycle overhead, allows up to 128 accumulations without the 
possibility of an overflow. The least-significant six bits of the product are lost, and 
the MSBs are filled with sign bits. This feature is initiated by setting the PM bits of 
status register ST1 to ‘11’ using the SPM or LST1 instructions. 


The TMS320C25 also has a right shift of the accumulator (using the SFR instruction) 
to scale down the accumulator when it nears overflow. 


Scaling the data coming into the accumulator or already in the accumulator is useful 
in signal processing algorithms. This is frequently necessary in adaptation or other 
algorithms that must compute and apply correction factors or normalize intermediate 
results. Scaling and normalizing are implemented on the TMS320C25 via right and 
left shifts in the accumulator and shifts of data on the incoming path to the accu- 
mulator. 


Right and left shifts of the accumulator can be performed using the SFL and SFR 
instructions. SFL performs a logical left shift. SFR performs logical or arithmetic right 
shifts depending on the state of the SXM bit in the status register. A ‘1’ in the SXM 
bit, corresponding to sign-extension enabled, causes an arithmetic shift to be 
performed. 


In addition to the shift instructions, data can be left-shifted 0 to 15 bits when the 
accumulator is loaded using a LAC instruction, and left-shifted 0 to 7 bits when 
storing from the accumulator using SACH or SACL instructions. These shifts can 
be used for loading numbers into the high 16 bits of the accumulator and renor- 
malizing the result of a multiply. The incoming left shift of 0 to 15 bits can be supplied 
in the instruction itself or can be taken from the lowest four bits of the T register. 
Left shifts of data fetched from data memory are available for loading the accumulator 
(LAC/LACT), adding to the accumulator (ADD/ADDT), and subtracting from the 
accumulator (SUB/SUBT). The contents of the P register may also be shifted prior 
to accumulation. 


5.6.3 Moving Data 
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Many DSP applications must perform convolution operations or other operations 
similar in form. These operations require data to be shifted or delayed. The DMOV, 
LTD, and MACD instructions can perform the needed data moves for convolution. 


The data move function allows a word to be copied from the currently addressed 
data memory location in on-chip RAM to the next higher location while the data from 
the addressed location is being operated upon (e.g., by the CALU). The data move 
and the CALU operation are performed in the same cycle. In addition, an ARAU 
Operation may also be performed in the same cycle when using the indirect 
addressing mode. The data move function is useful in implementing algorithms, such 
as convolutions and digital filtering, where data is being passed through a time 
window. It models the z~! delay operation encountered in those applications. The 
data move function is continuous across the boundary of the on-chip data memory 
blocks BO, B1, and B2. However, the data move function cannot be used if off-chip 
memory is referenced. 
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In Example 5-20, the following equation is implemented: 


2 
Yin) = Hk) X(n-K) 
k=0 


where the H values stay the same, and the X values are shifted each time the 
microprocessor performs one of the following series of multiplications (similar to 
operations performed in FIR filters): 


First Series: Y(2) = (HO) (X2) +(H1)(X1)+(H2) (XO) 
Second Series: Y(3) = (HO) (X3)+(H1) (X2) + (H2) (X1) 
Third Series: Y(4) = (HO) (X4) +(H1) (X3) +(H2) (X2) 


The MACD instruction, which combines accumulate and multiply operations with a 
data move, is tailored to the type of calculation shown in the summation equation 
above. In order to use MACD, the H values have been stored in block BO, configured 
as program RAM, and the X values have been read into block B1 of data RAM as 
shown in Figure 5-2. 


PROGRAM DATA 
BLOCK 0 BLOCK B1 
Pc——} H2 }-—>FFO0 + >300-—— x2 


Hi f}—>FFo1 >301——}_ x1 
HO >FFO2 >302 | xO | ARI 


(COEFFICIENTS) (SAMPLES) 


Figure 5-2. MACD Operation 


Also in Example 5-20, the summation in the above equation is performed in the 
reverse order, i.e., from K = 2 to O, due to the operation of the data move function. 
This results in the oldest X value being used and discarded first. 


If the MACD instruction is replaced with the following two instructions, then the 
MAC instruction can be utilized with the same results. 


MAC * 
DMOV Rae 


In cases where many more than three MACD instructions are required, the RPT or 
RPTK instructions may be used with MACD, yielding the same computational results 
but using less assembly code. 
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Example 5-20. Using MACD for Moving Data 


THIS ROUTINE IMPLEMENTS A SINGLE PASS OF A THIRD-ORDER FIR 
FILTER. IT IS ASSUMED THAT THE H AND X VALUES HAVE ALREADY 
BEEN LOADED INTO THEIR RESPECTIVE MEMORY LOCATIONS, THAT 
THE ACCUMULATOR AND P REGISTER ARE BOTH RESET TO ZERO, AND 
THAT AR1 IS POINTING AT XO. NOTE THAT THE MACD INSTRUCTION 
MAY BE USED IN THE REPEAT MODE, BUT IT IS NOT IMPLEMENTED 
HERE. 


+ ee + + He HF F 


FIR CNF'P 
LARP 1 
MAC >FFOQO, *= 


CONFIGURE BLOCK BO AS PROGRAM MEMORY. 
AR1 SHOULD POINT AT THE X VALUES. 
P = (XO) (H2) 


MACD >FFO1,*- ; ACC = (XO) (H2) 

MACD »>FFO2,* ; ACC =.(X0)(H2) +-(X1)(H1) 

APAC > ACC = (X0O)(H2) + (X1)(H1) + (X2) (HO) 
CNFD ; CONFIGURE BLOCK BO AS DATA MEMORY. 
RET > RETURN TO MAIN PROGRAM. 


5.6.4 Multiplication 


The TMS320C25 hardware multiplier normally performs two’s-complement 16-bit 
by 16-bit multiplies and produces a 32-bit result in one processor cycle. A single 
instruction, MPYU, can be used to multiply two 16-bit unsigned numbers. To 
multiply two operands, one operand must be loaded into the T register (TR). The 
second operand is moved by the multiply instruction to the multiplier, which then 
produces the product in the P register (PR). Before another multiply can be 
performed, the contents of the PR must be moved to the accumulator. A single- 
multiply program is shown in Example 5-21. By pipelining multiplies and PR moves, 
most multiply operations can be performed with a single instruction. 


A common operation in DSP algorithms is the summation of products. The MAC 
instruction, normally performed in four cycles, adds the contents of the PR to the 
accumulator and then simultaneously reads two values and multiplies them. When 
using the MAC instruction, a data memory value is multiplied by a program memory 
value. One of the operands can come from block B1 or B2 in on-chip data memory 
while the other operand. may come from block BO. Block BO must be configured as 
program memory when it supplies the second operand. Pipelining of the MAC 
instruction with a repeat instruction results in an execution time for each succeeding 
multiply-and-accumulate operation of only one cycle. 


Example 5-21. Multiply 
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* THIS ROUTINE MULTIPLIES TWO VALUES IN DATA MEMORY LOCATIONS 


* >200 AND >201 WITH THE RESULT STORED IN >202 AND >203. 
* 


MUL LRLK AR1,>200 ; POINT AT BLOCK BO. 
LARP 1 
LT + ; GET FIRST VALUE AT >200. 
MPY w+ ; MULTIPLY BY VALUE AT >201. 
PAC ; PUT RESULT IN ACCUMULATOR. 
SACL sake 3 ; STORE LOW WORD AT >202. 
SACH * ; STORE HIGH WORD AT >203. 
RET ; RETURN TO MAIN PROGRAM. 


The pipelining of the MAC and MACD instructions incurs a certain amount of 
overhead in execution. In those cases where speed is more critical than program 
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memory, it may be beneficial to use LTA or LTD and MPY instructions rather than 
MAC or MACD. Example 5-22 and Example 5-23 show an implementation of 
multiply-accumulates using the MAC instruction and the LTA-MPY instruction pair, 
respectively. Figure 5-3 and Figure 5-4 provide graphically the information necessary 
to determine the efficiency of use for each of the techniques. 


Example 5-22. Multiply-Accumulate Using the MAC Instruction 


* clock total clock program total program 
* cycles cycles memory memory 
* 

LARP AR1 1 a 

LRLK AR1,>300 2 2 

CNFP 1 1 

ZAC 1 a 

MPYK 0O 1 * 

RPTK Nel 1 3 

MAC 2EEOO t+. 3 + 2 

APAC 1 LL +B 1 10 


Example 5-23. Multiply-Accumulate Using the LTA-MPY Instruction Pair 


" clock total clock program total program 
: cycles cycles memory memory 
* 

ZAC i. 1 

LT D1 a. 4 

MP¥Y Cl i 1 

LTA D2 1 1 

MPY C2 vt 1 

2 x N 2x N 

LTA ODN 1 L 

MPY CN i 1 

APAC 1 2 +28 1 2 + 2n 
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=> «hb ah 
no > OD 


EXECUTION IN CLOCK CYCLES 
ro 


mo => DD @® 


bn aa 
ou ut. . ! @= LTA-MPY IMPLEMENTATION 
) ' x= BREAK-EVEN POINT 


‘ge ee eee Wee Fes cae eae foes ee: eS 
NUMBER OF MULTIPLY-ACCUMULATES TO BE 
PERFORMED 


Figure 5-3. Execution Time vs. Number of Multiply-Accumulates 
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PROGRAM MEMORY IN WORDS 


: | @ = MAC IMPLEMENTATION 
‘> @ = LTA-MPY IMPLEMENTATION 
: : % = BREAK-EVEN POINT 


1.238.484 -&- BAtb A 8 AT 
NUMBER OF MULTIPLY-ACCUMULATES TO BE 
PERFORMED 


Figure 5-4. Program Memory vs. Number of Multiply-Accumulates 


In numerical analysis, it is often necessary to square numbers along with adding or 
subtracting. The TMS320C25 has two instructions, SQRA and SORS, that accom- 
plish this in a single machine cycle. The result of the previous operation in the PR 
is first added to the accumulator if SORA is used, or subtracted from the accumulator 
if SQRS is used. Then the data value addressed is squared, and the result is stored 
in the PR. Example 5-24 uses the SORA instruction to perform the computation. 


Example 5-24. Using SQRA 


+ + * OF HF 


DIST 


DF *2 


= (XA - XB)**2 + (YA 


=e “se Se “6 


THIS ROUTINE USES THE SQRA INSTRUCTION TO COMPUTE THE 
SQUARE OF THE DISTANCE BETWEEN TWO POINTS WHERE D**2 
IS DEFINED AS FOLLOWS: 


YB) **2 


XT = XA - XB 


YT = YA = YB 


(P) = xXT**2 

(ACC) = 0 

(P) = ¥T**2, (ACC) = XT4*2 
(ACC) = XT**2 + YT**2 = D**2 


RETURN TO MAIN PROGRAM. 
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When performing multiply-and-accumulate operations, it may be desirable to shift 
the product before adding it to the accumulator. This can be accomplished simul- 
taneously with the MAC instruction by using the product shift mode. This mode, 
controlled by two bits in the PM field of status register ST1, shifts the value from the 
PR while it is transferred to the accumulator. The contents of the PR are not shifted. 


5.6.5 Division 
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Division is implemented on the TMS320C25 by repeated subtractions using SUBC, 
a special conditional subtract instruction. Given a 16-bit positive dividend and 
divisor, the repetition of the SUBC command 16 times produces a 16-bit quotient 
in the low accumulator and a 16-bit remainder in the high accumulator. 


SUBC implements binary division in the same manner as is commonly done in long 
division. The dividend is shifted until subtracting the divisor no longer produces a 
negative result. For each subtract that does not produce a negative answer, ‘1’ is 
put in the LSB of the quotient and then shifted. The shifting of the remainder and 
quotient after each subtract produces the separation of the quotient and remainder 
in the low and high halves of the accumulator. 


There are similarities between long division and the SUBC method of division. Both 
methods are used to divide 33 by 5. 
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LONG DIVISION: 


00000000000001 10 Quotient 
0000000000000101 
-101_ 
110 
-101 
11 Remainder 
SUBC METHOD: 
32 HIGH ACC | LOW ACC s COMMENT 
0000000000000000 0000000000100001 (1) Dividend is loaded into ACC. The 
-10 1000000000000000 divisor is left-shifted 15 and sub- 
-10 0111111111011111 tracted from ACC. The subtraction 


is negative, so discard the result 
| | and shift left the ACC one bit. 


0000000000000000 0000000001000010 (2) 2nd subtract produces negative 
-10 1000000000000000 answer, so discard result and shift 
rs ACC (dividend) left. 


& S 
. @ 
| 
0000000000000100 0010000000000000 (14) 14th SUBC command. The result 


-~10 1000000000000000 is positive. Shift result left and 
0000000000000001 1010000000000000 replace LSB with 


0000000000000011 0100000000000001 (15) Result is again positive. Shift 
-10 1000000000000000 result left and replace LSB with ‘1’. 


| | | | 
0000000000000001 1000000000000011 (16) Last subtract. Negative answer, so 
-10 1000000000000000 discard result and shift ACC left. 


0000000000000011 0000000000000110 Answer reached after 16 SUBC 


instructions. 
| REMAINDER | | QUOTIENT | 


Note that since the condition of the divisor being less than the shifted dividend is 
determined by the sign of the result, both the dividend and divisor must be positive 
when using the SUBC command. Thus, the sign of the quotient must be determined 
and the quotient computed using the absolute value of the dividend and divisor. 


Integer and fractional division can be implemented with the SUBC instruction as 
shown in Example 5-25 and Example 5-26, respectively. When implementing a 
divide algorithm, it is important to know if the quotient can be represented as a 
fraction and the degree of accuracy to which the quotient is to be computed. For 
integer division, the absolute value of the numerator must be greater than the absolute 
value of the denominator. For fractional division, the absolute value of the numerator 
must be less than the absolute value of the denominator. 
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Example 5-25. Using SUBC for Integer Division 


* THIS ROUTINE IMPLEMENTS INTEGER DIVISION. 


* 


DN1 LT 
MPY 
PAC 
SACH 
LAC 
ABS 
SACL 
ZALS 
ABS 


IF DIVISOR 
HERE. 


+ + + 


RPTK 
SUBC 
SACL 
LAC 
BGEZ 
ZAC 
SUB 
SACL 
DONE LAC 
RET 


NUMERA 
DENOM 


TEMSGN 
DENOM 


DENOM 
NUMERA 


AND DIVIDEND 


15 
DENOM 
QUOT 
TEMSGN 
DONE 


QUOT 
QUOT 
QUOT 


. 
’ 


e 
7 


e 
’ 


e 
, 


GET SIGN OF QUOTIENT. 


SAVE SIGN OF QUOTIENT. 


MAKE DENOMINATOR POSITIVE. 
ALIGN NUMERATOR. 


ARE ALIGNED, DIVISION CAN START 


° 
/ 


e 
y 


° 
7 


« 
/ 


16-CYCLE DIVIDE LOOP. 


DONE IF SIGN IS POSITIVE. 


NEGATE QUOTIENT IF NEGATIVE. 


RETURN TO MAIN PROGRAM. 


Example 5-26. Using SUBC for Fractional Division 
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* THIS ROUTINE IMPLEMENTS FRACTIONAL DIVISION. 


* 


DN1 LT 
MPY 
PAC 
SACH 
LAC 
ABS 
SACL 
ZALH 
ABS 


IF DIVISOR 
HERE. 


+ + + + 


RPTK 
SUBC 
SACL 
LAC 
BGEZ 
ZAC 
SUB 
SACL 
DONE LAC 
RET 


NUMERA 
DENOM 


TEMSGN 
DENOM 


DENOM 
NUMERA 


AND DIVIDEND 


14 
DENOM 
QUOT 
TEMSGN 
DONE 


QUOT 
QUOT 
QUOT 


GET SIGN OF QUOTIENT. 


SAVE SIGN OF QUOTIENT. 


MAKE DENOMINATOR POSITIVE. 
ALIGN NUMERATOR. 


ARE ALIGNED, DIVISION CAN START 


L15-CYCLE DIVIDE LOOP: 


DONE IF SIGN IS POSITIVE. 


NEGATE QUOTIENT IF NEGATIVE. 


RETURN TO MAIN PROGRAM. 
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5.6.6 Floating-Point Arithmetic 


Floating-point numbers are often represented on microprocessors in a two-word 
format of mantissa and exponent. The mantissa is stored in one word. The exponent, 
the second word, indicates how many bit positions from the left the decimal point 
is located. If the mantissa is 16 bits, a 4-bit exponent is sufficient to express the 
location of the decimal point. Because of its 16-bit word size, the 16/4-bit float- 
ing-point format functions most efficiently on the TMS320C25. 


Operations in the TMS320C25’s central ALU are performed in two’s-complement 
fixed-point notation. To implement floating-point arithmetic, operands must be 
converted to fixed point for arithmetic operations, and then converted back to floating 
point. 


Conversion to floating-point notation is performed by normalizing the input data (i.e., 
shifting the MSB of the data word into the MSB of the internal memory word). The 
exponent word then indicates how many shifts are required. To multiply two float- 
ing-point numbers, the mantissas are multiplied and the exponents added. The 
resulting mantissa must be renormalized. (Since the input operands are normalized, 
no more then one left shift is required to normalize the result.) 


Floating-point addition or subtraction requires shifting the mantissa so that the 
exponents of the two operands match. The difference between the exponents is used 
to left-shift the lower power operand before adding. Then, the output of the add 
must be renormalized. 


TMS320C25 instructions useful in floating-point operations are the NORM, LACT, 
ADDT, and SUBT instructions. NORM (see Example 5-7) may be used to convert 
fixed-point numbers to floating-point. LACT may be used to convert back to 
fixed-point numbers. Addition and subtraction can be computed in floating point 
using ADDT and SUBT. 


Example 5-27 performs a floating-point multiply. The mantissas are assumed to be 
in Q15 format. Q15, one of the various types of QO format, is a number representation 
commonly used when performing operations on non-integer numbers. In Q format, 
the Q number (15 in Q15) denotes how many digits are located to the right of the 
decimal point. A 16-bit number in Q15 format, therefore, has an assumed decimal 
point immediately to the right of the most significant bit. Since the most significant 
bit constitutes the sign of the number, then numbers represented in Q15 may take 
on values from +1 (represented by +0.9999999...) to -1 (represented by 
-0.9999999...). 
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Example 5-27. Using NORM for Floating-Point Multiply 
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* THIS SUBROUTINE PERFORMS A FLOATING-POINT MULTIPLY USING 
* THE NORM INSTRUCTION. THE INPUTS AND OUTPUTS ARE OF THE 
* FORM: 
* 
* C = MC * 2**EC 
* 
* SINCE THE MANTISSAS, MA AND MB, ARE NORMALIZED, MC CAN BE 
* NORMALIZED WITH A LEFT SHIFT OF EITHER O OR 1 IN THE 
* ACCUMULATOR. THE EXPONENT OF THE RESULT IS ADJUSTED 
* APPROPRIATELY. FOR EXAMPLE, MULTIPLICATION OF THE TWO 
* NUMBERS A AND B, WHERE A = 0.1 * 2**2 AND B = 0.1 * 2**4, 
* PROCEEDS AS FOLLOWS: 
* 
* 1) A. * B= 0,01-* 2**6 
* 2)°A *°Bo= O11 *2**5 (NORMALIZED RESULT) 
* 
MULT LAC EA 
ADD EB ; EC = EXPONENT OF RESULT BEFORE 
SaCt EC ; NORMALIZATION. 
LT MA 
MPY MB 
PAC ; (ACC) = MA * MB 
* 
SFL ; TAKES CARE OF REDUNDANT SIGN BIT. 
LARP AR5 
LAR AR5,EC ; AR5 IS INITIALIZED WITH EC. 
* 
NORM *- ; FINDS MSB AND MODIFIES ARS. 
* 
SACH MC ; MC = MA * MB (NORMALIZED) 
SAR AR5,EC 
RET ; RETURN TO MAIN PROGRAM. 


Floating-point implementation programs often require denormalization as well as 
normalization to return results in a 16-bit format. Example 5-28 is tailored for 
denormalizing numbers that were normalized using the NORM instruction. This 
program assumes that the mantissa is in the accumulator and the exponent is in AR5, 
which is the format of the NORM instruction after execution. 
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Example 5-28. Using LACT for Denormalization 


* THIS ROUTINE DENORMALIZES NUMBERS NORMALIZED BY THE NORM 
* INSTRUCTION. THE DENORMALIZED NUMBER WILL BE IN THE 


* ACCUMULATOR. 
* 


DENORM LARP 1 ; USE AR1 TO POINT AT BLOCK BO. 
LRLK AR1,>200 
SAR AR5,*+ ; STORE EXPONENT AT >200. 
SACH *- ; STORE MANTISSA AT >201. 
* 
* SUBTRACT EXPONENT FROM 16 TO DETERMINE THE NUMBER OF SHIFTS 
* REQUIRED TO DENORMALIZE. 
* 
LAC sb ; LOAD ACCUMULATOR WITH EXPONENT. 
BZ OUT ; CHECK FOR ZERO EXPONENT. 
Lf *+ 
LACT’ .* ; DENORMALIZE NUMBER. 
RET ; RETURN TO MAIN PROGRAM. 
OUT MAR  _*+ ; POINT TO MANTISSA. 
ZALH * ; LOAD ACCUMULATOR WITH RESULT. 
RET ; RETURN TO MAIN PROGRAM. 


5.6.7 Indexed Addressing 


The Auxiliary Register Arithmetic Unit (ARAU) allows the the next indirect address 
to be calculated using increment/decrement calculations or indexed addressing in 
parallel to the current arithmetic operation. For example, in the multiplication of two 
matrices, the operation requires addressing across the rows (incrementing the address 
by one) or down the columns (incrementing by n). Example 5-29 gives the code for 
multiplying a row times a column of two 10 x 10 matrices. The first matrix resides 
in data RAM block B1, and the second matrix resides in block BO. 


Example 5-29. Row Times Column 


LARK 0,>A ; SET INDEX TO 10. 

LARP 1 ; USE AR1 FOR ADDRESSING THE COLUMN. 

LELE: 11,7300 ; POINT AR1 TO THE START OF BLOCK Bl. 

CNFP ; SET BO TO PROGRAM ADDRESS FOR PIPELINING. 
ZAC ; INITIALIZE THE ACCUMULATOR. 

MPYK 0 ; CLEAR THE PRODUCT REGISTER. 

RPTK 9 ; REPEAT 10 TIMES AS DIMENSION OF MATRIX. 
MAC >FOOO,*O+ ; MULTIPLY ROW ELEMENT TIMES COLUMN ELEMENT. 
APAC ; EXECUTE FINAL ACCUMULATION. 


ACCUMULATOR CONTAINS PRODUCT ELEMENT. 


The algorithm in Example 5-29 executes in 22 machine cycles. The key to this 
performance is the parallel addressing of both multiplicands simultaneously. The 
operation is made possible by the use of the data bus to fetch one multiplicand and 
the program bus to fetch the other. The auxiliary register indexes down the column 
of one matrix while the PC generates incremental addressing of each row of the other 
matrix. Each cycle of the repeat loop performs the following operations: 


1) Accumulates the previous product, 

2)  Miultiplies the row element times the column element, 
3) Increments the row address, and 

4) Indexes the column address. 
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5.6.8 Extended-Precision Arithmetic 
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Numerical analysis, floating-point computations, or other operations may require 
arithmetic to be executed with more than 32 bits of precision. Two features of the 
TMS320C25 help to make extended-precision calculations more efficient. One of the 
features is the carry status bit. This bit is affected by all arithmetic operations of the 
accumulator (ABS, ADD, ADDH, ADDK, ADDS, ADDT, ADLK, APAC, LTA, LTD, 
LTS, MAC, MACD, MPYA, MPYS, NEG, SBLK, SPAC, SQRA, SQRS, SUB, SUBB, 
SUBC, SUBH, SUBK, SUBS, and SUBT). The carry bit is also affected by the rotate 
and shift accumulator instructions (ROL, ROR, SFL, and SFR) or may be explicitly 
modified by the load status register ST1 (LST1), reset carry (RC), and set carry (SC) 
instructions. For proper operation, the overflow mode bit should be reset (OVM=0) 
so that the accumulator results will not be loaded with the saturation value. Note that 
this means that some additional code may be required if overflow of the most 
significant portion of the result is expected. 


The carry bit is set whenever the addition of a value from the input scaling shifter 
or the P register to the accumulator contents generates a carry out of bit 31. Other- 
wise, the carry bit is reset since the carry out of bit 31 is a zero. One exception to this 
case is the ADDH instruction which can only set the carry bit. This allows the 
accumulation to generate the proper single carry when either the addition to the lower 
or upper half of the accumulator actually causes the carry. The following examples 
help to demonstrate the significance of the carry bit for additions: 


C MSB LSB C MSB LSB 

X FFFF FFFF ACC X FFFF FFFF ACC 
fs 1 +F PPP FFE FE 

10000 0000 1 FFFF FFFE 

X 7FFF FFFF ACC X 7TFFF FFFF ACC 
AOSD iis SAE Pe I | bail wi ke et Sale es Os aN 

0 8000 0000 1 7FFF FFFE 

X 8000 0000 acc X 8000 0000 acc 

0 8000 0001 1 7TFFF FFFF 

1 0000 0000 acc 1 FFFF FFFF ACC 
+ (ADDC) + QO (ADDC) 

0 TOOT OOF 1 0000 0000 

1 8000 FFFF Acc 1 8000 FFFF ACC 
+ (ADDH) +7 FF (ADDH) 

1 80 F 1 FFFF F 


Example 5-30 shows an implementation of two 64-bit numbers added to each other 
to obtain a 64-bit result. 
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Example 5-30. 64-Bit Addition 


* TWO 64-BIT NUMBERS ARE ADDED TO EACH OTHER PRODUCING A 
* 64-BIT RESULT. THE NUMBERS X (X3,X2,X1,X0) AND Y 
* (Y3,Y2,Y1,Y0O) ARE ADDED RESULTING IN W (W3,W2,W1,W0O). 


* 
X¥F M2Z-X1 XO 
* + Y3 Y2 Y1 YO 
Rt te De ae oe ee oe oo 
* W3 W2 W1 WO 
* 
ADD64 ZALH X1 ; ACC = X10 
ADDS xO > ACC = X1780 
ADDS YO ; ACC = X1 XO + 00 YO 
ADDH Yl > ACC = X1;X0 +:¥i-YO = W1 wo 
SACL wO 
SACH W1 
ZALH = -X3 » ACC = X3-<Q0 
ADDC x2 ; ACC = X3-K2 +:¢ 
ADDS yY2 ; ACC = X35¥2 +:60,¥2 + C 
ADDH  Y3 2 ACC = XIek2 +553572 + C = W3 W2 
SACL W2 
SACH W3 
RET 


In a similar way, the carry bit is reset whenever the input scaling shifter or the P-re- 
gister value subtracted from the accumulator contents generates a borrow into bit 
31. Otherwise, the carry bit is set since no borrow into bit 31 is required. One 
exception to this case is the SUBH instruction which can only reset the carry bit. 
This allows the generation of the proper single carry when either the subtraction from 
the lower or upper half of the accumulator actually causes the borrow. The following 
examples help to demonstrate the significance of the carry bit for subtractions: 


Cc MSB LSB C MSB LSB 
Xx 0000 0000 acc Xx 0000 0000 acc 
- 1 -FFFF FFFF 
O FFFF FFFF 0 0000 0001 
X 7F F ACC X T7FFF FFFF ACC 
- 1 -FFFF FFFF 
4:9 E 0 6000 0000 
x 80 00 ACC Xx 8000 0000 acc 
- 1 -FFFF FFFFE 
‘7 7 0 8000 0007 
0000 0000 acc O FF F F ACC 
wc wieepeicriinigsings tl OD - QO (SUBB) 
FFRFF FFFF 1 =F : 
8000 FFFF acc 0 8000 FFFF ACC 
-0001 0000 (SUBH) -FFFF 0000 (SUBH) 
0 7 F FFFF 0 86000 FFFF 


Example 5-31 provides the code for the implementation of two 64-bit numbers 
subtracted to obtain a 64-bit number. 
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Example 5-31. 64-Bit Subtraction 
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* TWO 64-BIT NUMBERS ARE SUBTRACTED, PRODUCING A 64-BIT 
* RESULT. THE NUMBER Y (Y3,Y2,Y1,Y0) IS SUBTRACTED FROM 


* X (X3,X2,X1,X0) RESULTING IN W (W3,W2,W1,W0O). 


Ft et + + + + 


SUB64 ZALH 
ADDS 
SUBS 
SUBH 
SACL 
SACH 
ZALS 
SUBB 
ADDH 
SUBH 
SACL 
SACH 
RET 


The second feature of the TMS320C25 aiding in extended-precision calculations is 
the MPYU (unsigned multiply) instruction. The MPYU instruction allows two 
unsigned 16-bit numbers to be multiplied and the 32-bit result placed in the product 
Efficiency is gained by the ability to generate partial 
products from the 16-bit portions of a 32-bit or larger value instead of having to split 
the value into 15-bit or smaller parts. Example 5-32 shows an implementation of 


register in a single cycle. 


a3 X23 ke 


= ¥3--¥2 -EE erg 


=e =e “se 6 


=e “se \“e we 


00 


00 


zo 


multiplying two 32-bit numbers to obtain a 64-bit result. 


Wl WO 
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Example 5-32. 32 x 32-Bit Multiplication 


* TWO 32-BIT NUMBERS ARE MULTIPLIED, PRODUCING A 64-BIT 
* RESULT. THE NUMBERS X (X1,X0) AND Y (Y1,Y0O) ARE 
* MULTIPLIED RESULTING IN W (W3,W2,W1,W0). 


* 


x F 2 &¢ Ue SS FS ESS OH FS 


MPY 32 


* 


* TAKE THE ABSOLUTE VALUE 


* 
ABSX 


ABSY 


* 


* MULTIPLY 


# 
MULT 


SUM 


ZALS 
XOR 
SACH 


ZALH 
ADDS 
ABS 

SACH 
SACL 
ZALH 
ADDS 
ABS 

SACH 
SACL 


LT 
MPYU 
SPL 
SPH 
MPYU 
LTP 
MPYU 
ADDS 


MPYA 


SACL 
SACH 
ZALS 


BNC 

ADDH 
APAC 
SACL 
SACH 


|X| 


W3 W2 W1 WO 


X1 
be 


SIGN 


AND |Y| 


e 
7 
° 
/ 


e 
/ 


=e “se “=e Se 


=e “=e “Se 


DETERMINE THE SIGN OF THE PRODUCT. 


ACCL = SXXX XXXX XXXX XXXX 
ACCL = S--- ---- ---- ---- 
SAVE THE PRODUCT SIGN O=+, 1=-. 
OF BOTH X AND Y. 

ACEs= 1X2: 00 

ACC = %1-X0 

SAVE |X1]|. 

SAVE |XO|. 

Acc =:¥T..00 

ACE = 97 ke 

SAVE |Y1]|. 

SAVE |YO|. 

PRODUCE |W]. 

T = xO 

T = XO, P = XO*YO 

SAVE |WO|. 

SAVE PARTIAL |W1]. 

T= .00. po = 4Oee) 

T = ¥1, P= KOFYL, ACC = Xory1 
= Xi. Pp. = Pieve, ACC m XO*Y1 
f= kt, Pe Re yG. 

ACC = XO*Y1 + XO*YO*2**-16 

ae see ET ee eee 

ACC = X1*YO + XO*Y1 + XO*YO*2**-16 
SAVE |W1|. 

SAVE PARTIAL |W2]. 

Pp = X1*Y1, 

ACC = (X1*YO + XO*Y1)*2**-16 


TEST FOR CARRY FROM W2. 


ACC = X1*Y1 + (X1*YO + XO*Y1)*2**-16 
SAVE |W2]|. 
SAVE |W3]. 
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* TEST THE SIGN OF THE PRODUCT; NEGATE IF NEGATIVE. 
* 
LAC SIGN 
BZ DONE ; RETURN IF POSITIVE. 
* 
ZALH W1 >; ACC -=-|W1 00] 
ADDS wO > ACC = |W1 WO] 
CMPL 
ADD ONE ; ACC = Wl WO AND CARRY GENERATION 
SACL  woO ; SAVE WO. 
SACH Wl ; SAVE Wl. 
ZALS W2 > ACC = |00 W2| 
ADDH W3 ; ACC = |W3 W2| 
CMPL 
ADDC ONE ; ACC = W3 W2 
SACL Ww2 ; SAVE W2. 
SACH W3 ; SAVE W3. 


DONE RET 


5.7 Application-Oriented Operations 


The TMS320C25 has been designed to provide efficient implementations of many 
common digital signal processing algorithms. The architecture supporting these 
design features was discussed in Section 3. In general, the features provide efficient 
solutions to numerically intensive problems usually characterized by 
multiply/accumulates. Some device-specific features that aid in the implementation 
of specific algorithms are discussed in this section. 


5.7.1 Companding 
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Applications implemented on the TMS320C25 include filtering, FFTs, and more 
complex processes comprised primarily of filtering and FFTs. These applications 
require |/O performed either in parallel or serial. Hardware requirements for |/O are 
discussed in Sections 3 and 6. 


In the area of telecommunications, one of the primary concerns is the |/O bandwidth 
in the communications channel. One way to minimize this bandwidth is by 
companding. Two modes commonly used are A-law and u-law companding. 
Detailed descriptions of companding are found in the application report available 
from Texas Instruments (see the book, Digital Signal Processing Applications with 
the TMS320 Family). 


The technique of companding allows the digital sample information corresponding 
to a 13-bit dynamic range to be transmitted as 8-bit data. For processing in the 
TMS320C25, it is necessary to convert the 8-bit (logarithmic) sign-magnitude data 
to a 16-bit two’s-complement (linear) format. Prior to output, the linear result must 
be converted to the compressed or companded format. Table lookup or conversion 
subroutines may be used to implement these functions. 


In expanding from the 8-bit data to the 13-bit linear representation, table lookup is 
very effective since the table length is only 256 words. This is especially true for a 
microcomputer design since the TMS320C25 has 4K words of mask-programmable 
ROM. The table lookup technique requires three instructions (four words of program 
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memory), one data memory location, 256 words of table memory, and seven 
instruction cycles (program in on-chip ROM) to execute. 


LAC SAMPLE ; LOAD 8-BIT DATA. 
ADLK MUTABL ; ADD THE CONVERSION TABLE BASE ADDRESS. 
TBLR SAMPLE ; READ THE CORRESPONDING LINEAR VALUE. 


The above conversion could be programmed as a subroutine. This would eliminate 
the need for a table, but would increase execution time and require additional data 
memory locations. 


When the output data has been determined in a system transmitting companded data, 
a compression of the data must be performed. The compression reduces the data back 
to the 8-bit format. Unless memory for a table of length 16384 is acceptable, the table 
lookup approach must be abandoned for conversion routines. Details of these 
implementations may be found in the application report on companding. 


5.7.2 Filtering 


Digital filters are a common requirement for digital signal processing systems. The 
filters fall into two basic categories: Finite Impulse Response (FIR) and Infinite 
Impulse Response (IIR) filters. For either category of filter, the coefficients of the filter 
(weighting factors) may be fixed or adapted during the course of the signal proc- 
essing. The theory and implementation of digital filters has been presented and 
discussed in an application report (see the book, Digital Signal Processing Applica- 
tions with the TMS320 Family). The TMS320C25 reduces the execution time of 
all filters by virtue of its 100-ns instruction cycle time. 


IIR filters benefit from the 100-ns instruction cycle time of the TMS320C25. IIR 
filters typically require fewer multiply/accumulates. Correspondingly, the amount of 
data memory for samples and coefficients is not usually the limiting factor. Because 
of sensitivity to quantization of the coefficients themselves, IIR filters are usually 
implemented in cascaded second-order sections. This translates to instruction code 
consisting of LTDs and MPYs rather than MACDs. 


FIR filters also benefit from the faster instruction cycle time. In addition, an FIR filter 
requires many more multiply/accumulates than does the IIR filter with equivalent 
sharpness at the cutoff frequencies and distortion and attenuation in the passbands 
and stopbands. The TMS320C25 can help solve this problem by making longer filters 
feasible to implement. This is accomplished by allowing the coefficients to be fetched 
from program memory at the same time as a sample is being fetched from data 
memory. The simple implementation of this process uses the MACD instruction with 
the RPT/RPTK instruction. 


Ree: . oko 
MACD *-,COEFFP 


The coefficients may be stored anywhere in program memory (reconfigurable on-chip 
RAM, on-chip ROM, or external memories). When the coefficients are stored in 
on-chip ROM or externally, the entire on-chip data RAM may be used to store the 
sample sequence. Ultimately, this allows filters of up to 512 taps to be implemented 
on the TMS320C25. Execution of the filter will be at full speed or 100 ns per tap 
as long as the memory supports full-speed execution. 


Up to this point, it has been assumed that the filter coefficients are themselves fixed. 
If the coefficients are adapted or updated with time, then another factor impacts the 
computational capacity. The second factor is the requirement to adapt each of the 
coefficients, usually with each sample. New instructions (MPYA or MPYS and ZALR) 
on the TMS320C25 aid with this adaptation to reduce the execution time. A means 
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of adapting the coefficients is the Least- Mean-Square (LMS) algorithm given by the 
following equation: 


by(i+1) = b,(l) + 2B el) x(I-k) 
where a(i) = x(i) - y(l) 


N-1 
and y(i) = } by x(i-k) 
k=0 


Quantization errors in the updated coefficients can be minimized if the result is 
obtained by rounding rather than truncating. For each coefficient in the filter at a 
given point in time, the factor 2*B*e(i) is a constant. This factor can then be 
computed once and stored in the T register for each of the updates. Thus, the 
computational requirement has become one multiply/accumulate plus rounding. 
Without the new instructions, the adaptation of each coefficient is five instructions 
corresponding to five clock cycles. This is shown in the following instruction 
sequence: 


LRLK AR2,COEFFD ; LOAD ADDRESS OF COEFFICIENTS. 
LRLK AR3,LASTAP ; LOAD ADDRESS OF DATA SAMPLES. 


LARP AR2 

LT ERRF > errf = 2*B*e(i) 

ZALH *,AR3 * ACC = bk(i)*2**16 

ADD ONE,15 * ACC = bk(i)*2**16 + 2**15 

MPY *%¥-  AR2 

APAC * ACC = bk(i)*2**16 + errf*x(i-k) + 2**15 
SACH *+ » SAVE bk(itl1). 


When the MPYA and ZALR instructions are used, the adaptation reduces to three 
instructions corresponding to three clock cycles, as shown in the following instruc- 
tion sequence. Note that the processing order has been slightly changed to incor- 
porate the use of the MPYA instruction. This is due to the fact that the accumulation 
performed by the MPYA is the accumulation of the previous product. 


LRLK AR2,COEFFD ; LOAD ADDRESS OF COEFFICIENTS. 
LRLK AR3,LASTAP ; LOAD ADDRESS OF DATA SAMPLES. 


LARP AR2 

ip yy ERRF - errf = 2*B*e(i) 

ZALR *,AR3 ACC = bk(i)*2**16 + 2**15 

MPYA *-,AR2 ACC = bk(i)*2**16 + errf*x(i-k) + 2**15 


PREG = errf*x(i-k+1) 
SAVE bk(itl1). 


=e “=e “oe “6 


SACH ..*+ 


Example 5-33 shows a routine to filter a signal and update the coefficients. The total 
execution time of the routine is 33 + 4n where n is the filter length. Data and program 
memory requirements are 5 + 2n and 30 + 3n words, respectively. Note that for 
adaptive filters, the filter length is restricted both by execution time as well as memory. 
There is obviously more processing to be completed per sample due to the adaptation, 
and the adaptation itself dictates that the coefficients be stored in the reconfigurable 
block of on-chip RAM. Thus, the practical limit of an adaptive filter with no external 
data memory is 256 taps. 
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Example 5-33. 256-Tap Adaptive FIR Filter 


TITL ‘ADAPTIVE FILTER' 
DEF ADPFIR 
DEF X,Y 


THIS 256-TAP ADAPTIVE FIR FILTER USES ON-CHIP MEMORY BLOCK 
BO FOR COEFFICIENTS AND BLOCK Bl FOR DATA SAMPLES. 
NEWEST INPUT SHOULD BE IN MEMORY LOCATION X WHEN CALLED. 
THE OUTPUT WILL BE IN MEMORY LOCATION Y WHEN RETURNED. 

IS O WHEN THE ROUTINE IS CALLED. 


* 

* 

* 

* 

x 

* ASSUME THAT THE DATA PAGE 

k 

COEFFP EQU >FFOO ; 

COEFFD EQU >0200 : 

x 

ONE EQU >7A : 

BETA EQU >7B : 

ERR EQU Pa ie : 

ERRF EQU >7D ; 

¥ EQU >7E : 

X EQU >7F : 

FRSTAP EQU >0300 : 
>O3FF : 


LASTAP EQU 
* 


* FINITE IMPULSE RESPONSE (FIR) 


* 


ADPFIR CNFP ; 


FIR 


+ 


MPYK OQ ; 
LAC ONE, 14 : 
LARP AR3 

LRLK AR3,LASTAP ; 
RPTK 255 

MACD COEFFP,*- ; 
CNFD : 
APAC 

BACH -Y,1 : 
NEG 
ADD 
SACH 


ha ‘ 
ERR,1 : 


BO PROGRAM MEMORY ADDRESS 
BO DATA MEMORY ADDRESS 


CONSTANT ONE (DP=0) 
ADAPTATION CONSTANT (DP=0) 
SIGNAL ERROR (DP=0) 
ERROR FUNCTION (DP=0) 
FILTER OUTPUT (DP=0) 
NEWEST DATA SAMPLE (DP=0) 


NEXT NEWEST DATA SAMPLE 
OLDEST DATA SAMPLE 


FILTER. 
CONFIGURE BO AS PROGRAM: 


Clear the P register. 
Load output rounding bit. 


Point to the oldest sample. 


256-tap FIR filter. 
CONFIGURE BO AS DATA: 


Store the filter output. 


Add the newest input. 
erelr) = Ck) =. vis 


LMS ADAPTATION OF FILTER COEFFICIENTS. 


LT ERR 

MPY BETA 

PAC : 
ADD ONE , 14 : 
SACH ERRF,1 

MAR + 

LAC X ° 
SACL * 

LRLK AR2,COEFFD H 
LRLK AR3,LASTAP : 
joy ERRF 

MPY *—  AR2 : 


errf(i) = beta * err(i) 
ROUND THE RESULT. 


INCLUDE NEWEST SAMPLE. 


POINT TO THE COEFFICIENTS. 
POINT TO THE DATA SAMPLES. 


P = 2*beta*err(i)*x(1i-255) 


THE 
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LOAD ACCH WITH b255(i) & ROUND. 
B255CaeiP c= B2Z5S(i) +. P 

P = 2*beta*err(i)*x(1i-254) 
STORE 625501132 


ADAPT ZALR *,AR3 
MPYA *-,AR2 


=e “=e Se OO 


SACH *+,0,AR1 


ZALR *,AR3 
MPYA *-,AR2 


LOAD ACCH WITH b254(i) & ROUND. 
b254(it1) = b254(i) + P 

P = 2*beta*err(i)*x(i-253) 
STORE b254(it1). 


=e ™=s “e ‘“e 


SACH *+,0,AR1 


ZALR *,AR3 
MPYA *-,AR2 


LOAD ACCH WITH b253(i) & ROUND. 
b253(iti) = b253 (1) -+°P 

P = 2*beta*err(i)*x(i-252) 
STORE b253(it1). 


=e “=e se we 


SACH: *+,0,ARi 


ZALR *,AR3 
MPYA *-,AR2 


LOAD ACCH WITH bl1(i) & ROUND. 
b1(itl) = b1(i) + P 

P = 2*beta*err(i)*x(i-0O) 
STORE BEtitl1) . 


=e =e =e se 


SACH ¥*+,0,ARL 


ZALR *,AR3 ; LOAD ACCH WITH bO(i) & ROUND. 
APAC *-,AR2 ; bO(i+1) = bO(i) + P 
SACH *+,0,AR1 ;. STORE BO itl). 
* 
RET ; RETURN TO CALLING ROUTINE. 


5.7.3 Fast Fourier Transforms (FFT) 
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Fourier transforms are an important tool often used in digital signal processing 
systems. The purpose of the transform is to convert information from the time domain 
to the frequency domain. The inverse Fourier transform converts information back 
to the time domain from the frequency domain. Implementations of Fourier transforms 
that are computationally efficient are known as Fast Fourier Transforms (FFTs). The 
theory and implementation of FFTs on the TMS32020 has been discussed in an 
application report in the book, Digital Signal Processing Applications with the 
TMS320 Family. The TMS320C25 reduces the execution time of all FFTs by virtue 
of its 100-ns instruction cycle time. 


In addition to the shorter cycle time, an addressing feature has been added to the 
TMS$320C25 which provides execution speed and program memory enhancements 
for radix-2 FFTs. As demonstrated in Figure 5-5 and Figure 5-6 the inputs or outputs 
of an FFT are not in sequential order, i.e., they are scrambled. The scrambling of the 
data addressing is a direct result of the radix-2 FFT derivation. Observation of the 
figures and the relationship of the input and output addressing in each case reveal 
that the address indexing is a bit-reversed order, as shown in Table 5-1. As a result, 
either the data input sequence or the data output sequence must be scrambled in 
association with the execution of the FFT. 
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STAGE 1 STAGE 2 STAGE 3 
x(O) 


X(0) 
wo vs 
x(4) aes X(1) 
a ae, 
x(2) ° X(2) 
wo , 
x(6) ex X(3) 
wo map 
x(1) : Se X(4) 
@ 
= = 
a a> 
x(3) . e X(6) 
& 
x(7) 0 


LEGEND FOR TWIDDLE FACTOR: WO =W3 w1 =We W2 =Ws W3=Ws 


X(7) 


Figure 5-5. An In-Place DIT FFT with In-Order Outputs and Bit-Reversed 
Inputs 


STAGE 1 STAGE 2 STAGE 3 
x(O) X(0) 
x(1) Le X(4) 
x(2) . : X(2) 
e9 
x(3) o:¢ (6) 
cif noenes OS X(1) 
ag. 
xi} : : X(5) 
X(7) 


0 _vwyl _wy2 _w 
8 W1=We. W2=We W3=We 


x(7) wo 


LEGEND FOR TWIDDLE FACTOR: WO=W 


Figure 5-6. An In-Place DIT FFT with In-Order Inputs but Bit-Reversed 
Outputs 
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Table 5-1. Bit-Reversal Algorithm for an 8-Point Radix-2 DIT FFT 


| INDEX | — BITPATTERN BIT-REVERSED PATTERN BIT-REVERSED INDEX 


NO h WN — © 


On the TMS32020 the bit reversal was handled by loading the accumulator with pairs 
of points that needed to be swapped and then storing them back in the swapped 
locations. A new addressing feature that uses reverse carry-bit propagation allows 
the TMS320C25 to scramble the inputs or outputs while it is performing the I/O. 
The addressing mode is part of the indirect addressing implemented with the auxiliary 
registers and the associated arithmetic unit. In this mode (a derivative of indexed 
addressing), a value (index) contained in ARO is either added or subtracted from the 
auxiliary register being pointed to by the ARP. However, instead of propagating the 
carry bit in the forward direction, it is propagated in the reverse direction. The result 
is a scrambling in the address access. 


The procedure for generating the bit-reversal address sequence is to load ARO with 
a value corresponding to the length of the FFT and to load another auxiliary register, 
e.g., AR1, with the base address of the data array. Implementations of FFTs involve 
complex arithmetic; as a result, there are two data memory locations (one real and 
One imaginary) associated with every data sample. Generally, the samples are stored 
in memory in pairs with the real part in the even address locations and the imaginary 
part in the odd address location. This means that the offset from the base address 
for any given sample is twice the sample index. Real input data is easily transferred 
into the data memory and stored in the scrambled order, with every other location 
in the data memory representing the imaginary part of the data. 
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The following list shows the contents of auxiliary register AR1 when ARO is initialized 
with a value of 8 (8-point FFT) and when data is being transferred by the code that 


follows. 


ARO: 


AR1: 


AR1: 


AR1: 


AR1: 


AR1: 


AR1: 


AR1: 


AR1: 


AR1: 


MSB 
000 


000 


RPTK 
IN 


000 


000 


000 


000 


000 


000 


000 


000 


0 0000 
0 0010 
7 

*BRO+, PAO 
0 0010 
Os; O01 9 
oO). O.G7 0 
0 0010 
0 0010 
Oo 00 10 
Oo C9010 
Oo. 0010 


oO oO Oo 


© 


oOo oOo 


LSB 


00 


00 


8-Point FFT 


Base Address 


XR(0) 
XR (4) 
XR(2) 
XR (6) 
XR(1) 
XR(5) 
XR (3) 


XR(7) 


Example 5-34 consists of lists of macros used in the implementation of FFTs. The 
first macro implements the bit reversal in the way necessary for the TMS32020 and 


is not necessary for implementations on the TMS320C25. 
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Example 5-34. FFT Macros 
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BITREV SMACRO PR,PI,QR,QI 
* 


* BIT REVERSAL CODE - SWAP PR AND QR, SWAP PI AND QI. 
* 


ZALH 
ADDS 
SACL 
SACH 
ZALH 
ADDS 
SACL 
SACH 
SEND 


* 


COMBO S$MACRO R1,11,R2,12,R3,13,R4,14 
< 


* CALCULATE PARTIAL TERMS FOR R3, R4, 13, AND I4. 
* 


LAC 
ADD 
SACH 
SUB 
SACH 
LAC 
ADD 
SACH 
SUB 
SACH 
* 


* CALCULATE 

* 
LAC 
ADD 
SACH 
SUB 
ADD 
SACH 
SUBH 
DMOV 
SACH 
LAC 
ADD 
SACH 
SUB 
SUB 
SACH 
ADDH 
SACH 


* 


* CALCULATE 
* 


LAC 
ADD 
SACH 
SUBH 
SACH 
LAC 
ADD 
SACH 
SUBH 
SACH 
SEND 


-R3 
:R4 


:R3:; 
:R4: 


PARTIAL TERMS FOR 


PARTIAL TERMS FOR 


¢, 4 
:,14 


3,14 
:,14 
oe 
> eed 
ae he 


bya 
Se 


ead 
tya5 


ve) 


a 


(1/4) (R3) 

(1/4) (R3+R4) 

(1/2) (R3+R4) 

(1/4) (R3+R4)-(1/2) (R4) 
(1/2) (R3-R4) 

(1/4) (13) 

(1/4) (I13+1I4) 

(1/2) (I3+14) 

(1/4) (I13+14)-(1/2) (14) 
(1/2) (53=14) 


2, RA, I2,“AND 14. 


(1/4) (R1) 

(1/4) (R1+R2) 

(1/2) (R1+R2) 

(1/4) (R1+R2)-(1/2) (R2) 
(1/4) [(R1-R2)+(13-14) ] 
(1/4) [(R1-R2)+(13-14) ] 
(1/4) [(R1-R2)-(13-I14) ] 
R4 = (1/2) (R3-R4) 
(1/4) [(R1-R2)-(13-I4) ] 
(1/4) (11) 

(1/4){I1+12) 
(A722 Tt T1452) 

(1/4) (I11+12)-(1/2)-(22) 
(1/4) [ (11-12) -(13-14) ] 
(1/4) [(11-12)-(13-14) ] 
(1/4) [(11-1I2)+(13-14) ] 
(1/4) [(11-12)+(13-I4) ] 


icp BS, 21, ARTS. 


(1/4) (R1+R2) 

(1/4) [(R1+R2)+(R3+R4) ] 
(1/4) [(R1+R2)+(R3+R4) ] 
(1/4) [(R1+R2) -(R3+R4) ] 
(1/4) [(R1+R2) -(R3+R4) ] 
(1/4) (I1+I2) 

(1/4) [(11+12)+(13+14) ] 
(1/4) [(I1+1I2)+(13+14) ] 
(1/4) [(11+12)-(13+14) ] 
(1/4) [(11+12)-(13+14) ] 
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* 
ZERO $MACRO PR,PI,QR,QI 
* 


* CALCULATE Re[P+Q] AND Re[P-Q] 
* 


LAC 3PR:-,15.. ACC 
ADD sOR+, 15 ACC 
SACH :PR: PR 
SUBH sUR* ACC 
SACH sOR: OR 


* 


houu tt i 
PRP PE 
be. tia Ry 
NMNNN 

ae) 

v9) 

+ 

v9) 


PR-QR) 


* CALCULATE Im[P+Q] AND Im[P-Q] 
* 


LAC Pils ,-15 - ACC 
ADD SOI § p45.° REC 
SACH a PI 
SUBH sobs ACC 
SACH sE.: Ql 
SEND 


PIBY4 $MACRO PR,PI,QR,QI,W 
* 


LT :W: 

LAC sOI:,14 ACC 
SUB 7OR:,14 ACC 
SACH SOlian OI 
ADD SOR ssh pois 
SACH rom? , + OR 
LAC :PR:,14 ACC 
MPY :OR: P REG 
APAC ACC 
SACH 2PRs yl PR 
SPAC ACC 
SPAC ACC 
SACH oR fe dk OR 
LAC cPit;2¢. Awe 
MPY OL: P REG 
APAC ACC 
SACH sPle,l PI 
SPAC ACC 
SPAC ACC 
SACH sOis,4 OI 
SEND 


* 
PIBY2 S$MACRO PR,PI,QR,QI 
* 


uu ud 
Ft te 
PHP E 
oe ee 
NO BO NO NO NO 
Fe ee et 

ry 

KH 

+ 

Hi 


PI-QI) 


T REGISTER := W=COS(PI/4)=SIN(PI/4) 


= (1/4) (QI+QOR) *W 
PR+(QI+QR) *W] 
PR+(QI+QOR) *W] 
PR) 
PR-(QI+QOR) *W] 
PR-(QI+QR) *W] 
PT) 

= (1/4) (QI-QR) *W 
PI+(QI-QR) *W] 
PI+(QI-OR) *W] 
PT) 
P 
P 


Ke eH 
onbudbdbwmhund vd dwalit t te uu 


I-(QI-QR) *w] 
I-(QI-QR) *w] 


* CALCULATE Re[P+jQ] AND Re[P-3jQ] 
* 


LAC ePI:,15. ACC 
SUB rR: 25. ACC 
SACH PI: PI 
ADDH 2OR: ACC 
SACH :OR: OR 


& 
(1 
ee! ) 
(1 PI-OR)+(QR) 
ee 


tie Nis. Stine Die 


* CALCULATE Im[P+jQ] AND Im[P-jQ] 
* 


LAC :PR:,15 ACC 
ADD wisy;ao 6 6=©6ACC 
SACH :PR:; PR 
SUBH 102 2 ACC 
DMOV sOR: OR 
SACH TOR: OR 
SEND 


ivi wv uel 
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* 
PI3BY4 SMACRO PR,PI,QOR,QI,W 
* 


ut :W: T REGISTER := W=COS(PI/4)=SIN(PI/4) 
LAC :01:,14 .ACC. :=°(274) (OT) 

SUB :OR:,14 ACC := (1/4) (QI-QR) 

SACH :QOI:,1 OI = (1/2) (QI-QR) 

ADD :OR:,15 ACC := (1/4) (QI+OR) 

SACH :OR:,1 OR = (1/2) (QI+QR) 

LAC sPR:,14 ACC := (1/4) (PR) 

MPY OL: P REGISTER := (1/4) (QI-QR) *W 
APAC ACC := (1/4) [PR+(QI-QR) *w] 
SACH :PR:,1 PR = (1/2) [PR+(QI-QR) *W] 
SPAC ACC := (1/4) (PR) 

SPAC ACC := (1/4) [PR-(QI-QR) *W] 
MPY :OR: P REGISTER := (1/4) (QI+QR) *W 
SACH >OR:,1 OR = (1/2) [PR-(QI-QR) *Ww] 
LAC sPI:,14 ACC := (1/4) (PI) 

SPAC ACC := (1/4) [PI-(QI+QR) *w] 
SACH PPiz,) 1 PI = (1/2) [PI-(QI+OR) *w] 
APAC ACC := (1/4) (PI) 

APAC ACC := (1/4) [PI+(QI+QR) *W] 
SACH sOT 3.1 OI = (1/2) [PI+(QI+QOR) *W] 
SEND 


Example 5-35 shows the bit-reversal addressing capability of the TMS320C25 for 
implementing an 8-point DIT FFT. On the TMS320C25 the following instructions 
input the data and store it in memory in the bit-reversed sequence: 


RPTK 7 
IN *BRO+, PAO 


This code combines the functions of input and bit-reversal addressing which were 
previously implemented separately on the TMS32020. The following implementation 
uses a separate bit-reverse macro: 


RPTK 7 
IN *0+,PAO 


BITREV X1R,S11,X4R,X4I 
BITREV X3R,S31,X6R,X6I 
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Example 5-35. An 8-Point DIT FFT 


XOR EQU 00 
XOI EQU O01 
X1R EQU 02 
a2 EQU 03 
X2R EQU 04 
X2I EQU 05 
X3R EQU 06 
X31 EQU 07 
X4R EQU 08 
X41 EQU 09 
X5R EQU 10 
X51 EQU La 
X6R EQU 12 
X61 EQU 13 
X7R EQU 14 
X71 EQU 15 
W EQU 16 
WVALUE EQU >5A82 ; VALUE FOR SIN(45) OR COS(45) 
* 


* INITIALIZE FFT PROCESSING. 
* 


rrr 


* 


SPM O : NO SHIFT OF PR OUTPUT 

SSXM ; SET SIGN-EXTENSION MODE. 
ROVM ; RESET OVERFLOW MODE. 

LDPK 4 ; SET DATA PAGE POINTER TO 4. 
LALK WVALUE ; GET TWIDDLE FACTOR VALUE. 
SACL W ; STORE SIN(45) OR COS(45). 


* INPUT SAMPLES, STORING IN BIT-REVERSED ORDER. 
. 


* 


LARK ARO ,8 ; LOAD LENGTH OF FFT IN ARO. 

LRLK AR1,>200 ; LOAD AR1 WITH DATA PAGE 4 ADDRESS. 
LARP AR1 

RPTK 7 

IN *BRO+,PAO ; ONLY REAL-VALUED INPUT 


* FIRST & SECOND STAGES COMBINED WITH DIVIDE-BY-4 INTERSTAGE 


SCALING 
* 


+ 


COMBO xXOR,X0O1I,X1R,X11,X2R,X21,X3R,X31, 
COMBO X4R,X41I,X5R,X51I,X6R,X61I,X7R,X71. 


* THIRD STAGE WITH DIVIDE-BY-2 INTERSTAGE SCALING 
* 


* 


ZERO XOR,XOI,X4R,X41 
PIBY4 X1R,X11I,X5R,X51I,W 
PIBY2 X2R,X21I,X6R,X6ol 
PI3BY4 X3R,X31,X7R,X71I,W 


* OUTPUT SAMPLES, SUPPLYING IN SEQUENTIAL ORDER. 
* 


LRLK AR1,>200 ; LOAD AR1 WITH DATA PAGE 4 ADDRESS. 
RPTK 15 

OUT *+,PAO ; COMPLEX-VALUED OUTPUT 

RET 
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Table 5-2 provides a comparison of execution speed, program memory, and data 
memory for an 8-point DIT FFT implementation using the TMS32020 and 
TMS320C25. 


Table 5-2. FFT Memory Space and Time Requirements 


DEVICE WORDS IN MEMORY CPU CYCLES TIME 
Data Program (us) 

TMS32020 17 169 216 43.2 
TMS320C25 17 153 178 17.8 
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6. Hardware Applications 


Information and examples on how to interface the TMS320C25 to external devices 
are presented in this section. The examples given are general enough in nature that 
they may be easily adapted to fit a particular system requirement. 


The following buses, ports, and control signals provide system interface to the 
TMS320C25 processor: 


16-bit address bus (A15-A0) 

16-bit data bus (D15-D0) 

Serial port 

PS, DS, IS (program, data, |/O space select) 
R/W (read/write) and STRB (strobe) 

READY and MSC (microstate complete) 

HOLD and HOLDA (hold acknowledge) 
INT(2-0) and IACK (interrupt acknowledge) 
XF (external flag) and BIO (branch control) 
SYNC (synchronization) and BR (bus request) 


Major hardware applications discussed in this section are listed below. 


External Local Memory Interface (Section 6.1 on page 6-2) 
Wait States (Section 6.2 on page 6-3) 

Direct Memory Access (Section 6.3 on page 6-4) 

Global Memory (Section 6.4 on page 6-6) 

Codec Interface (Section 6.5 on page 6-7) 

|/O Ports (Section 6.6 on page 6-8) 
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6.1 External Local Memory Interface 
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The external local memory interface provides the versatility to interface the 
TMS320C25 to a wide variety of memory devices. For example, if speed and maxi- 
mum throughput are desired, the TMS320C25 can run with zero wait states and 
perform memory accesses in a single machine cycle. The TMS320C25 can access 
slower memories by inserting one or more wait states into the memory access oper- 
ation by using the READY input signal. 


If the internal data RAM on the TMS320C25 is sufficient for system needs, a minimal 
memory configuration, such as the one shown in Figure 6-1, can be implemented. 
In the example, two (2K x 8) PROMs are used as program memory. No address 
decoding is performed, and the PS control signal is used as the chip enable. 


Depending on the access time of the PROMs, the READY input can be either 
connected to a logic high for zero wait states or connected to the MicroState 
Complete (MSC) pin for automatic one wait-state generation. 


TBP38L165 


TMS320C25 


T4ALS3 


Figure 6-1. Minimal External Program Memory Configuration 
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6.2 Wait States 


The number of cycles in a memory or |/O access is determined by the state of the 
READY input. At the start of quarter-phase 3, the TMS320C25 samples the READY 
input. If READY is high, the memory access ends at the next falling edge of 
CLKOUT1. If READY is low, the memory cycle is extended by one machine cycle, 
and all other signals remain valid. At the beginning of the next quarter-phase 3, this 
sequence is repeated. Figure 6-2 shows a one wait-state memory access. Note that 
for on-chip program and data memory accesses, the READY input is ignored. 


eee 34 SE 8 Bee 


CLKOUT1 


: LAR ARAARAAAAAAAAAAAAAAA AAA 
y KY +4 AY) ‘YS AAAS ‘YY \ *'s + 's +¢ XXX) AY +6’ 


SERPOOOOOOOOOOOOFOOOEOEOOOOES LAAAAM MAARRARAAAAAAAAAAAAAAAAAAAAARAY 
FOUOU OUD OUU UU OU O ROO RX KX KAA KKK KAKA 
0000000000000 000000000 CX « WARRARRARARAR 


D15-DO 
(FOR READ 
OPERATION) 


D15-D0 
(FOR WRITE 
OPERATION) 


RT | eaRRaRSSTTTTSTISIOIC0O 

YY YY XX A: DOO OOO OOOO KKK Kg 

OOK DOK X KX XA KAX KAN 
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Figure 6-2. One Wait-State Memory Access Timing 


The automatic generation of one wait state can be accomplished by the use of the 
MicroState Complete (MSC) signal. The MSC output is asserted low during 
CLKOUT1 low to indicate the beginning of an internal or external memory or |/O 
Operation (see Figure 6-2). By gating MSC with the address and PS, DS, and/or 
1S, a one-wait READY signal can be generated (see Figure 6-3). 
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Figure 6-3. One Wait-State Generator Using MSC 


6.3 Direct Memory Access 
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The TMS320C25 supports Direct Memory Access (DMA) to its. external 
program/data memory using the HOLD and HOLDA signals. Direct memory access 
can be used for multiprocessing by temporarily halting the execution of one or more 
processors to allow another processor to read from or write to the halted processor’s 
local off-chip memory. Here the multiprocessing is typically a master-slave config- 
uration. The master may initialize a slave by downloading a program into its program 
memory space and/or provide the slave with the necessary data to complete a task. 


In a typical TMS320C25 direct memory access scheme, the master may be a gener- 
al-purpose CPU, another TMS320C25, or perhaps even an analog-to-digital 
converter. A simple TMS320C25 master-slave configuration is shown in Figure 6-4. 
The master TMS320C25 takes complete control of the slave’s external memory by 
asserting HOLD low via its external flag (XF). This causes the slave to place its 
address, data, and control lines in a high-impedance state. By asserting RS in 
conjunction with HOLD, the master processor can load the slave’s local program 
memory with the necessary initialization code on reset or powerup. The two 
processors can be synchronized using the SYNC pin to make the transfer over the 
memory bus faster and more efficient. 


After control of the slave’s buses is given up to the master processor, the slave alerts 
the master of this fact by asserting HOLDA. This signal may be tied to the master 
TMS320C25’s BIO pin. The slave’s XF pin may be used to indicate to the master 
when it has finished performing its task and needs to be reprogrammed or requires 
additional data to continue processing. In a multiple slave configuration, the priority 
of each slave’s task may be determined by tying the slave’s XF signals to the 
appropriate INT(2-0) pin on the master TMS320C25. 
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Figure 6-4. Direct Memory Access Using a Master-Slave Configuration 


A PC environment presents another example of a potential direct memory access 
scheme where a system bus (the PC-bus) is used for data transfer. In this config- 
uration, either the master CPU or a disk controller may place data onto the system 
bus, which can be downloaded into the local memory of the TMS320C25. Here the 
TMS320C25 acts more like a peripheral processor with multifunction capability. In 
a speech application, for example, the master can load the TMS320C25’s program 
memory with algorithms to perform such tasks as speech analysis, synthesis, or 
recognition, and fill the TMS320C25’s data memory with the required speech 
templates. In another application example, the TMS320C25 can serve as a dedicated 
graphics engine. Programs can be stored in TMS320C25 program ROM or down- 
loaded via the system bus into program RAM. Data can come from PC disk storage 
or provided directly by the master CPU. 


Figure 6-5 depicts a direct memory access using a PC environment. In this config- 
uration, decode and arbitration logic is used to control the direct memory access. 
When the address on the system bus resides in the local memory of the peripheral 
TMS320C25, this logic asserts the HOLD signal of the TMS320C25 while sending 
the master a not-ready indication to allow wait states. After the TMS320C25 
acknowledges the direct memory access by asserting HOLDA, READY is asserted and 
the information transferred. 
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Figure 6-5. Direct Memory Access in a PC Environment 


6.4 Global Memory 
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In various digital signal processing tasks, such as filters or modems, the algorithm 
being implemented may be divided into sections with a distinct processor dedicated 
to each section. In this multiple processor scheme, the first and second processors 
may share global data memory, as well as the second and third, the third and fourth, 
etc. Arbitration logic may be required to determine which section of the algorithm 
is executing and which processor has access to the global memory. With. multiple 
processors dedicated to distinct sections of the algorithm, throughput may be 
increased via pipelined execution. 


The external memory of the TMS320C25 can be divided into both global and local 
sections. Special registers and pins included on the TMS320C25 allow multiple 
processors to share up to 32K words of global data memory. This implementation 
facilitates efficient “shared data” multiprocessing where data is transferred between 
two or more processors. Unlike a direct memory access scheme, reading or writing 
global memory does not require one of the processors to be halted. 


The size of the global memory is programmable between 256 and 32K locations in 
data memory by loading the global register (GREG). After global memory is defined 
in the GREG, the TMS320C25 asserts the BR (bus request) signal before each global 
memory access. The processor then inserts wait states until a bus grant is given by 
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asserting the READY line. Figure 6-6 illustrates such a global memory interface. 
Since the processors can be synchronized by using the SYNC pin, the arbitration logic 
may be simplified and the address and data bus transfers more efficient. 


The SYNC pin on the TMS320C25 may also be used to synchronize several proces- 
sors to allow for execution of redundant fail-safe systems. SYNC permits instruction 
broadcasting between several processors and lock-step execution after initial 
synchronization. 
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Figure 6-6. Global Memory Communication 


6.5 Codec Interface 


In some areas of telecommunications, speech processing, and other applications that 
require low-cost analog I/O devices, a codec may be useful. The combo-codec used 
here consists of nonlinear A/D and D/A converters with all the associated filters and 
data-holding registers. 


The TMS320C25 serial port allows communication with serial devices such as 
codecs. The speed and versatility of the TMS320C25 allow it to compand (COMpress 
and exPAND) a PCM (Pulse Code Modulation) data stream, acquired by the codec, 
through the TMS320C25 execution of software conversion routines (see the appli- 
cation report, “Companding Routines for the TMS32010/TMS32020,” in the book, 
Digital Signal Processing Applications with the TMS320 Family). Figure 6-7 shows 
an interface example of a Texas Instruments TCM2913 codec to the TMS320C25 
serial port. 
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Figure 6-7. Codec Interface 


In this configuration, all timing and synchronization signals are externally generated 
using independent oscillator and frequency-dividing hardware such as the 74AS867 
or 74LS161 counters. Alternatively, the designer may decide to generate the timing 
signals from the TMS320C25 clock by subdividing its frequency. 


In some circuits, it may be necessary to include an opamp at the analog output of 
the codec. In such cases or if variable output gain is required, a gain-setting resistor 
network must be provided as specified in the TCM2913 documentation. 


Other linear A/D and D/A converters may be interfaced to the TMS320C25 through 
its parallel ports as well as the serial ports. 


6.6 I/O Ports 
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|/O design on the TMS320C25 is treated the same way as memory. The |/O address 
space is distinguished from the local program/data memory space by the IS signal. 
1S goes low at the beginning of the memory cycle. All other control signals and timing 
parameters will be the same as those for the program/data external memory interface. 


The TMS320C25 software instructions can access 16 input and 16 output ports. 
The four least significant bits of the address bus specify the particular port being 
accessed. A pair of 74AS138s can be used to fully decode these address bits (see 
Figure 6-8). 
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Figure 6-8. I/O Port Addressing 


A simple interface between two processors can be implemented using up to 16 
bidirectional |/O ports connected to the TMS320C25. An interprocessor communi- 
cation path can be formed by memory-mapping peripherals to the |/O ports of the 
TMS320C25. In this manner, the TMS320C25 can connect to parallel A/Ds, registers, 
FIFOs, two-port memories, or other peripheral devices. In a multiprocessing scheme, 
intelligent peripherals can be memory-mapped into the I/O ports. Here the 
TMS320C25 can communicate with UARTs, general-purpose microprocessors, disk 
controllers, video controllers, or other peripheral processors. 


Using an 8-bit general-purpose microprocessor, such as Tl’s TMS7042, for a 
keyboard interface is an example of a TMS320C25 |/O port multiprocessing scheme, 
as shown in Figure 6-9. The TMS/7042 may be mapped into the TMS320C25 |/O 
space using latches to store the transferred data. In a single or multiple |/O port 
multiprocessing configuration, the four LSBs of the address bus are decoded to 
determine which of the 16 I/O ports on the TMS320C25 is being accessed. The 
TMS320C25 selects the |1/O space (IS) for its external bus and reads/writes data 
using the IN/OUT instructions. 


Processor-controlled signals between the TMS320C25 and the peripheral device 
indicate when data is available to be read. This interprocessor communication is 
facilitated by using the input and output pins of the TMS7042 (or other peripheral 
processor). In an |/O multiprocessing configuration, the |/O port address space is 
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limited, and data transfers are relatively slow compared to a direct memory access 
or global memory configuration. 
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Figure 6-9. I/O Port Processor-to-Processor Communication 


7. Assembler Directives 


The TMS320C25 Macro Assembler translates mnemonic instructions and assembler 
directives specified by the TMS320C25 assembly language source code into 
executable object code. Some directives make sections of the program relocatable, 
others define constants for data or text, and still others provide linkage between 
separate program modules to form a complete executable program. After the Link 
Editor links a program as required, the TMS320C25 Simulator provides simulation 
for effective software development and program verification. 


Given a file of TMS320C25 source code as input, the assembler outputs a listing file, 
an object file, an optional symbol table, and a cross-reference list. The assembler 
also provides a comprehensive set of error diagnostics. 


Major topics discussed in this section are listed below. 


@ Creation of TMS320C25 Source Code (Section 7.1 on page 7-2) 
Label field 
Command field 
Operand field 
Comment field 
Assembly language elements: 
- Symbols (Section 7.2 on page 7-4) 
- Constants (Section 7.3 on page 7-4) 
- Character strings (Section 7.4 on page 7-6) 
- Expressions (Section 7.5 on page 7-6) 


@ Assembler Directives (Section 7.6 on page 7-9) 
Functional groupings 


@ Individual Directive Descriptions (Section 7.7 on page 7-12) 
Presented in alphabetical order and providing the following: 
- Syntax 
- Description 
- Example(s) 
@ Source Listing Format (Section 7.8 on page 7-44) 
@ Object Code (Section 7.9 on page 7-45) 
Object code format 
Changing object code 
@ Cross-Reference Listing (Section 7.10 on page 7-50) 


@ Assembler Error Messages (Section 7.11 on page 7-51) 
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7.1 Creation of TMS320C25 Source Code 


The TMS320C25 assembly language consists of operation codes (called mnemonics) 
that correspond directly to binary machine instructions. An assembly language 
program is called a source program. Before it can be executed by the computer, the 
source program must be processed by the assembler to obtain a machine language 
program. This processing of a source program is called assembling. This consists 
of combining the binary values (which correspond to the operation code) with the 
binary address information to form the machine language instruction. 


The TMS320C25 Assembler is a two-pass assembler that processes source code 
twice. On the first pass, the assembler maintains the location counter (which defines 
the program memory addresses assigned to the resulting words of object code), 
builds a symbol table, and produces a list file of the source code. On the second 
pass, the assembler produces the object code using the operation codes and the 
symbol table of the first pass. 


An assembly language source program consists of source statements that may 
contain assembler directives, machine instructions, or comments. Source statements 
scanned by the assembler may contain four ordered fields (label, command, operand, 
and comment) separated by one or more blanks. Source statements containing an 
asterisk (*) in the first character position are comment statements, and as such, have 
no effect on the assembly. The source statement line may be as long as the source 
file format allows; however, the assembler truncates the source line to 60 characters 
without warning. Only comments may extend past column 60 without an error 
resulting. 


The TMS320C25 Assembler uses the ASCII character set. 


The syntax for source statements is as follows: 


[<label>] <mnemonic> [<operand>] [<comment>] 


A source statement may have a label that is user-defined. The label field begins in 
character position one of the source statement. At least one blank must separate the 
label from the command mnemonic, the mnemonic from the operand (when an 
operand is required), and the operand(s) from the comment field. 


The last source statement of a source program, usually the END directive, is followed 
by the end-of-file statement for the source medium. 


7.1.1. Label Field 
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The label field begins in character position one of the source statement and contains 
a label of up to six significant characters. The first character of the label must be 
alphabetic; additional characters may be alphanumeric. A label is optional for machine 
instructions and for many assembler directives. When the label is omitted, the first 
character position must contain a blank. 


A source statement consisting of only a label field is a valid statement. It has the 
effect of assigning the current value of the location counter to the label as well as 
to the next source statement. This is equivalent to the following directive statement: 


<label> EQU $§$ Where $ represents the current value of the location 
counter at that point in the assembly. 
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7.1.2 Command Field 


The command field begins after the blank that terminates the label field, or in the first 
non-blank character past the first character position (which must be blank when the 
label is omitted). The command field is terminated by one or more blanks and may 
not extend past the right margin. The command field may contain one of the 
following: 


@ Assembler mnemonic of a machine instruction (e.g., MAC) 
€ Macro mnemonic (e.g., FACT) 
@ Assembler directive (e.g., DATA) 


7.1.3  Operand Field 


The operand field begins following the blank that terminates the command field and 
may not extend past the right margin of the source statement. The operand field is 
terminated by one or more blanks. 


The operand field may contain one or more of the following: 


@ Constants 
@ Character strings 
« Expressions 


Symbols used in the operand field must be defined in the assembly, usually by 
appearing in the label field of a statement or in the operand field of a REF (external 
reference) or SREF (secondary external reference) directive. REF and SREF directives 
provide access to symbols defined in other programs. 


7.1.4 Comment Field 


The comment field begins after the blank terminating the operand field or the blank 
terminating the command field, as in the case of commands that have no operands. 
The comment field may extend to the end of the source statement (if required) and 
may contain any ASCII character including blank(s). The contents of the comment 
field up to the end of the source record are listed in the source portion of the assembly 
listing and have no other effect on the assembly. 
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7.2 Symbols 


Symbols are used in the label field and the operand field. A symbol is a string of 
alphanumeric characters, (‘A’ through ‘Z’, ‘0’ through ‘9’, and ’$’). The first character 
in a symbol must be ‘A’ through ‘Z’ or ‘S$’. No character may be blank. When more 
than six characters are used in a symbol, the assembler prints all the characters, but 
accepts only the first six characters for processing (the assembler prints a warning 
indicating that the symbol has been truncated). Therefore, symbols must be unique 
in the first six characters. User-defined symbols are valid only during the assembly 
in which they are defined. 


Symbols used in the label field become symbolic addresses. They are associated 
with locations in the program and must not be used in the label field of other state- 
ments. Mnemonic operation codes and assembler directive names may also be used 
as valid user-defined symbols when placed in the label field. 


Any symbol appearing in the label field of a source statement, other than an EQU 
(define assembly-time constant) directive, is either absolute or relocatable depending 
on whether or not the statement is in an absolute (specified) block of the program. 


7.2.1 Predefined Symbols 


The predefined symbols are the dollar sign character ($) and the auxiliary register 
and port symbols. The dollar sign character is used to represent the current location 
within the program. The auxiliary register symbols are of the form ‘ARn’ where ‘n’ 
is O to 4. The port addresses are of the form ‘PAn’ where ‘n’ is 0 through 15. 


Examples of valid predefined symbols: 


$ Represents the current location 
ARO Represents Auxiliary Register 0 
PA12 Represents Port Address 12 


7.3 Constants 
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The assembler recognizes the following five types of constants, each internally 
maintained as a 16-bit quantity: 


Decimal integer constants 
Binary integer constants 
Hexadecimal integer constants 
Character constants 
Assembly-time constants 


Decimal, binary, hexadecimal, and character constants are absolute. Assembly-time 
constants defined by absolute expressions are absolute, and assembly-time constants 
defined by relocatable expressions are relocatable. 
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7.3.1 Decimal Integer Constants 


A decimal integer constant is written as a string of decimal digits. Decimal integers 
range in value from -32,768 to +32,767. Positive decimal integer constants in the 
range of 32,768 to 65,535 are considered negative when interpreted as two’s- 
complement values. 


Examples of valid decimal constants: 


1000 Constant equal to 1000 or >3E8 
-32768 Constant equal to -32768 or >8000 
25 Constant equal to 25 or >19 


7.3.2 Binary Integer Constants 


A binary integer constant is written as a string of up to 16 binary digits (0 or 1) 
preceded by a question mark, ‘?’. If less than 16 digits are specified, the assembler 
right-justifies the given bits in the resulting constant. 


Examples of valid binary constants: 


?0000000000010011 Constant equal to 19 or >0013 
20111111111111111 Constant equal to 32767 or >7FFF 
211110 Constant equal to 30 or >OO1E 


7.3.3 Hexadecimal Integer Constants 


A hexadecimal integer constant is written as a string of up to four hexadecimal digits 
preceded by a ‘greater than’ sign, ‘>’. If less than four hexadecimal digits are spec- 
ified, the assembler right-justifies the given bits in the resulting constant. Hexade- 
cimal digits include the decimal values ‘0’ through ‘9’ and the letters ‘A’ through 'F’. 


Examples of valid hexadecimal constants: 


>78 Constant equal to 120 or >0078 
>F Constant equal to 15 or >OQO0OF 
>37AC Constant equal to 14252 or >37AC 


7.3.4 Character Constants 


A character constant is written as a string of one or two alphabetic characters 
enclosed in single quotes. Two consecutive single quotes represent each single 
quote contained within a character constant. If less than two characters are specified, 
the assembler right-justifies the given bits in the resulting constant. The characters 
are represented internally as eight-bit ASCII characters. A character constant 
consisting only of two single quotes (no character) is valid and is assigned the value 
0000 (hexadecimal). | 


Examples of valid character constants: 


‘AB’ Represented internally as >4142 
‘fC Represented internally as >0043 
"N’ Represented internally as >OO4E 
uy Represented internally as >2744 
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7.3.5 Assembly-Time Constants 


An assembly-time constant is a symbol given a value by an EQU directive. The value 
of the symbol, determined at assembly time, is considered to be absolute or relocat- 
able according to the relocatability of the expression, not according to the relocata- 
bility of the location counter value. Absolute value symbols may be assigned values 
with expressions using any of the above constant types. 


7.4 Character Strings 


Some assembler directives require character strings in the operand field. A character 
string is written as a string of characters enclosed in single quotes. Two consecutive 
single quotes represent a single quote in a character string. The maximum length 
of the string is defined for each directive requiring a character string. The characters 
are represented internally as eight-bit ASCII. 


Examples of valid character strings: 


"SAMPLE PROGRAM’ Defines a 14-character string consisting of SAMPLE 
PROGRAM. 


‘PLAN ’'C’”’ Defines an 8-character string consisting of PLAN ‘C’. 


7.5 Expressions 
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Expressions are used in operand fields of assembler directives and machine 
instructions. An expression is a constant or symbol, a series of constants or symbols, 
or a series of constants and symbols separated by arithmetic operators. Each constant 
or symbol may be preceded by a plus sign (unary plus), a minus sign (unary minus), 
or the # symbol (unary invert). Unary minus takes the two’s complement of the 
expression, and unary invert takes the one’s complement. The # symbol yields the 
value of the logical complement of the following constant or symbol. An expression 
does not contain embedded blanks. The valid range of values for an expression is 
-32,768 to +65,535. 


An expression is relocatable when the number of relocatable symbols or constants 
added to the expression is one greater than the number of relocatable symbols or 
constants subtracted from the expression. (All other valid expressions are absolute. ) 
When the first symbol or constant is unsigned, it is considered as added to the 
expression. For example, when all symbols in the following expressions are relo- 
catable, the expressions are relocatable: 


LABEL+1 
LABEL+TABLE+-INC 
-LABEL+TABLE+INC 
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7.5.1 Arithmetic Operators in Expressions 


Arithmetic operators used in expressions are as follows: bs 


+ for addition 

- for subtraction 

* for multiplication 
/ for division 


In evaluating an expression, the assembler first negates any constant or symbol 
preceded by a unary minus and then performs the arithmetic operations from left to 
right. The assembler does not assign precedence to any operation other than unary 
plus or unary minus. All operations are integer operations. The assembler truncates 
the fraction in division. When a unary minus follows a subtraction operator, the 
effective operation is addition. The unary minus cannot be applied to a relocatable 
expression or subexpression. For example, the expression 4+5*2 would be evaluated 
as 18, not 14; and the expression 7+1/2 would be evaluated as 4, not 7. 


The assembler checks for a valid range of values. The warning message ’VALUE 
TRUNCATED’ is given when a value is out of range. 


An example of where a ‘VALUE TRUNCATED’ message is given: 


B 65538 


7.5.2 Parentheses in Expressions 


The assembler supports the use of parentheses in expressions to alter the order of 
evaluation of the expression. Nesting of pairs of parentheses within expressions is 
also supported. Evaluation of portions of an expression within parentheses at the 
same nesting level may be considered to be simultaneous. Parentheses cannot be 
nested more than eight levels deep. 


For example, the use of parentheses in the expression LAB1+((4+3)*7) results in 
the following operation: 


1) Add four to three, 
2) Multiply the resulting sum by seven, and 
3) Add the resulting product to the value of LAB1. 


7.5.3  Well-Defined Expressions 


Some assembler directives require well-defined expressions in operand fields. For 
an expression to be well-defined, any symbols or assembly-time constants in the 
expression must have been previously defined. The evaluation of a well-defined 
expression must be absolute, and a well-defined expression must not contain a 
character constant. An example of a well-defined expression is as follows: 


>1000+X Where X must have been previously defined. 


737 
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7.5.4 Absolute and Relocatable Symbols in Expressions 


The value of an expression containing absolute or relocatable symbols is either 
absolute or relocatable depending on a precise set of rules. An expression containing 
a relocatable symbol or relocatable constant immediately following a multiplication 
or division operator is illegal. When the result of evaluating an expression up to a 
multiplication or division operator is relocatable, the expression is also illegal. Table 
7-1 defines the relocatability of the result for each type of operator. 


If the current value of an expression is relocatable with respect to one relocatable 
section, a symbol of another section cannot be included until the value of the 
expression becomes absolute. The following are examples of legal expressions: 


BLUE+1 The sum of the value of symbol BLUE plus one is legal and of the 
same type as BLUE. 


GREEN-4 The result of subtracting four from the value of symbol GREEN is 
legal and of the same type as GREEN. 


2*16+RED The sum of the value of symbol RED plus the product of two times 
16 is legal, and of the same type as RED. 


440/2-RED The result of dividing 440 by two and subtracting the value of 
symbol RED from the quotient (RED must be absolute for this to 
be a legal expression). 


Table 7-1. Results of Operations on Absolute and Relocatable Items 


RESULT RESULT RESULT 
OF OF OF 
A-B A*B A/B 


RELOC | RELOC | legal | Notes | illegal legal 


Notes: +. Illegal unless A equals zero or one. If A is one, the result is relocatable; if A is zero, the 
result is an absolute zero. 

Illegal unless B equals zero or one. If B is one, the result is relocatable; if B is zero, the 
result is an absolute zero. 

Illegal unless B equals one. If B equals one, the result is relocatable. 

Illegal unless A and B are in the same section. If A and B are in the same section, the result 
is absolute. 
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7.5.5 Externally Referenced Symbols in Expressions 
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As defined in the REF (external reference) and SREF (secondary external reference) 
directives, the assembler allows externally referenced symbols in expressions under 
the following conditions: 


1) Only one externally referenced symbol is used in an expression. 


2) The character preceding the referenced symbol must be a blank, a plus sign, 
or acomma. The portion of the expression preceding the symbol, if any, must 
be added to the symbol. 
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3) The portion of the expression following the referenced symbol must not include 
multiplication or division on the symbol (as for a relocatable symbol). 


4) The remainder of the expression following the referenced symbol must be 
absolute. 


The link editor resolves all externally referenced symbols automatically. However, 
the assembler limits the user to a total of 255 externally referenced symbols per 
module. Modules using more than 255 external symbols must be broken into smaller 
modules for assembly, and linked using the link editor. 


7.6 Assembler Directives 


Assembler directives are instructions that control the assembly process rather than 
produce object code for machine instructions. The TMS320C25 Assembler supports 
directives in the following categories: 


Directives that affect the location counter 
Directives that affect assembler output 

Directives that initialize constants 

Directives that provide linkage between programs 
Miscellaneous directives. 


7.6.1 Directives That Affect the Location Counter 


As the assembler reads the source statements of a program, the location counter is 
set to correspond to the memory locations assigned to the resulting object code. 
The thirteen assembler directives that affect the location counter are shown in Table 
7-2. The first nine initialize the location counter and define its value as relocatable, 
absolute, or dummy. The next two directives set the location counter to provide a 
block of program memory for the object code. The last two directives define a block 
of an independently stored program segment. 


Table 7-2. Assembler Directives That Affect the Location Counter 


Absolute origin 
Relocatable origin 

Dummy origin 

Block starting with symbol 
Block ending with symbol 
Data segment 


Data segment end 

Common segment 

Common segment end 
Program segment 

Program segment end 
Independent program segment 
Independent segment end 
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7.6.2 Directives That Affect Assembler Output 


Directives that affect assembler output (see Table 7-3) are primarily used to improve 
user interface. The first directive supplies a program identifier in the object code. 
The other five directives in this category format the source listing. 


Table 7-3. Assembler Directives That Affect Assembler Output 


DIRECTIVES |MNEMONICS| 


Program identifier 
Output options 


Page title 

Restart source listing 
Stop source listing 
Eject page 


7.6.3 Directives That Initialize Constants 


Table 7-4 lists those directives that initialize constants. DATA and TEXT assign 
hexadecimal values in successive words of the object code. EQU initializes a constant 
for use during the assembly process. 


Table 7-4. Assembler Directives That Initialize Constants 


DIRECTIVES MNEMONICS 


Initialize word DATA 
Initialize text TEXT 
Define assembly-time constant EQU 


7.6.4 Directives That Provide Linkage Between Programs 


Two pairs of directives, DEF/REF and SREF/LOAD, generate the information required 
to link program modules, thereby making it unnecessary to assemble an entire 
program in the same assembly. A long program may be divided into separately 
assembled modules to avoid a long assembly or to reduce the symbol table size. 
Modules common to several programs may also be combined as required. Program 
modules may be linked by the link editor to form a linked object module that may 
be stored on a library and/or loaded as required. 


The DEF/REF directives enable program modules to be assembled separately and 
integrated into an executable program. The DEF directive places one or more symbols 
defined in the module into the object code of the assembled module, thus making 
them available for linking. The REF directive places symbols used in the module, 
but defined in another module, into the object code of the assembled module, 
allowing them to be linked. 


The Link Editor’s major function is to provide symbol resolution for external references 
and definitions created by the REF and DEF assembler directives (see Table 7-5). 
Each symbol defined in a program module and required by other program modules 
must be placed in the operand field of a DEF directive in the program module defining 
it and in the operand field of a REF directive in the program module referencing it. 
All program modules to be linked by the link editor must include an IDT directive 
with a character string enclosed in single quotes placed in its operand field as the 
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program module name. The link editor builds a list of symbols from DEF directives 
as it links the program modules, and matches symbols from REF directives to the 
symbols in the list. The link editor follows linking commands to determine the 
modules to be linked. If the module in which a routine is defined has the same name 
as the routine entry points, the link editor can automatically locate the required 
module in a designated library. 


The Link Editor requires a link control file as input to specify the task name, to define 
the starting location for the data and program segments, and to indicate the object 
files to be linked. The following linker commands are the primary commands that 
should be included in a link control file: 


FORMAT ASCII 

TASK <taskname> 

PROGRAM >0000 

DATA >0000 

INCLUDE <object code filenames separated by commas> 
INCLUDE < or listed in separate INCLUDE commands > 
END 


The Link Editor outputs two files when linking TMS320C25 object modules. The 
first file is a source listing file that shows the source statement number, a location 
counter value, the assembled object code, the source statement as entered, and a 
cross-reference listing of externally defined variables. The second file contains the 
actual load module of linked object code to be executed by the TMS320C25. 


Table 7-5. Assembler Directives That Provide Linkage Between Programs 


| DIRECTIVES | MNEMONICS| 


External definition 


External reference 
Secondary external reference 
Force load 


7.6.5 Miscellaneous Directives 


This category includes assembler directives not applicable to the other categories. 


Table 7-6. Miscellaneous Assembler Directives 


DIRECTIVES /MNEMONICS| 


Program end END 
Copy source file COPY 
Define MACRO library MLIB 


The Macro Library (MLIB) assembler directive provides the TMS320C25 Assembler 
with the name of a library containing macro definitions. The operand of this directive 
is a directory pathname (constructed according to the conventions of the host 
operating system) enclosed in single quotes. The macros listed in this directory are 
user-defined, one macro per file. The MLIB directive is defined only for hosts that 
support libraries. 
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7.7 Individual Directive Descriptions 


Each TMS320C25 assembler directive is described in this section. Directives are listed 
in alphabetical order. 


The majority of the instruction symbols used to describe the syntax of the assembler 
directives is identical to those symbols in Table 4-2. Those that are introduced for 
the first time or have definitions specific to this section are listed in Table 7-7. 


Table 7-7. Assembler Directive Symbols 


TSyMBOL[ “MEANING 


label The contents of the label field 


exp An expression 


wd-exp A well-defined expression 


comment | The contents of the comment field 


string A character string 


// 


Items within slashes can be used only if the 
operand field is not empty. When not empty, 
they are optional. 


Items within brackets are optional. 


Items within single quotes are character 
constants or character strings. 


AORG Absolute Origin Directive AOQRG 


Syntax [<label>] AORG [<wd-exp> /<comment>/] 


When a label is used, it is assigned the value that the AORG directive places in 
the location counter. 


Description AORG places a value in the location counter and defines the succeeding locations 
as absolute. An absolute location is not affected by relocation. Upon encount- 
ering an AORG statement, the assembler places the value of the well-defined 
expression into the location counter. When no AORG is entered, no absolute 
addresses are included in the object program. When the operand field is not used, 
the length of all preceding absolute code replaces the value in the location 
counter. 


Example 1 AORG >1000+X 


>1000+X must be a well-defined expression. If X has a value of 6, the location 
counter is set to >1006. 


Example 2 HEX AORG >1000 


The location counter is set to >1000. The label HEX is assigned the value >1000. 


BES Block Ending with Symbol Directive BES 


Syntax 


Description 


Example 


[<label>] BES <wd-exp> [<comment>] 


When used, a label is assigned the value of the location following the block. 


BES advances the location counter by the value in the operand field. The operand 
field contains a well-defined expression representing the number of words to be 
added to the location counter. BES assigns a label the value of the location 
following the block. 


BUFF2 BES >10 


BES reserves a 16-word buffer. If the location counter contains >100 when the 
assembler processes this directive, BUFF2 is assigned the value >110. 


BSS 


Syntax 


Description 


Example 


Block Starting with Symbol Directive BSS 


[<label>] BSS <wd-exp> [<comment>] 


When used, a label is assigned the value of the location of the first word in the 
block. 


BSS advances the location counter by the value of the well-defined expression 
(wd-exp) in the operand field. The well-defined expression represents the number 
of words to be added to the location counter. BSS assigns a label the value of 
the location of the first word in the block. 


BUFF1 BSS § >10 


If the location counter contains > 100 when the assembler processes this directive, 
BUFF1 is assigned >100. The location counter is set to >110. 


CEND Common Segment End Directive CEND 


Syntax [<label>] CEND [<comment>] 
When used, a label is assigned the value of the location counter prior to modifi- 
cation. 

Description CEND terminates the definition of a block of common-relocatable code by placing 


a value in the location counter and defining succeeding locations as program- 
relocatable. CEND results in setting the location counter to one of these values: 


© The maximum value the location counter has ever attained as a result of the 
assembly of any preceding block of program-relocatable code, or 


e Zero, if no program-relocatable code has been previously assembled. 


lf encountered in data- or program-relocatable code, CEND functions as a DEND 
or PEND, and a warning message is issued. Like DEND and PEND, CEND is 
invalid when used in absolute code. 


Example See CSEG for an example of the use of CEND. 


COPY Copy Source File Directive COPY 


Syntax 


Description 


Example 


[<label>] COPY <file-name> [<comment>] 


COPY causes the assembler to read source statements from a different file. The 
file name may be one of the following: 


@ An access name recognized by the operating system, or 
@ Asynonym form of an access name. 


When end-of-file is reached, the assembler resumes processing source statements 
from the file or device previous to the COPY directive. A COPY directive may be 
placed in a file being copied. Nested copying of files can be performed by placing 
a COPY directive in a file being copied. Such nesting is limited by the assembler 
to eight levels; additional restrictions may be set by the host operating system. 


COPY SFILE.ASM 


COPY causes the assembler to take source statements from a file called 
SFILE.ASM. 


CSEG Common Segment Directive CSEG 


Syntax [<label>] CSEG ['<string>’ /<comment>/] 
When used, a label is assigned the value placed by the directive in the location 
counter. 

Description CSEG defines succeeding locations as common-relocatable. CSEG permits the 


construction and definition of independently relocatable data segments that 
several programs may access or reference at execution time. The segments are 
assembly language counterparts of FORTRAN COMMON. Information placed in 
the object code by the assembler permits the link editor to relocate all common 
segments independently and make appropriate adjustments to all addresses 
referencing locations within common segments. The difference between CSEG 
and DSEG is that locations within a particular common segment may be refer- 
enced by several different programs if each program contains a CSEG directive 
with the same operand or no operand. 


If the operand field is not used, the CSEG directive defines the beginning (or 
continuation) of the blank common segment of the program. When used, the 
operand field contains a character string of up to six characters enclosed in quotes. 
(If the string length exceeds six characters, the assembler prints a truncation error 
message and retains the first six characters of the string.) If this string has not 
previously appeared as the operand of a CSEG directive, the assembler associates 
a new relocation section number with the operand, sets the location counter to 
zero, and defines succeeding locations as relocatable with respect to the new 
relocatable section. When the operand string has been previously used in a CSEG, 
the succeeding code represents a continuation of the particular common segment 
associated with the operand. The location counter is reset to the maximum value 
attained during the previous assembly of any portion of that particular common 
segment. 


The following directives properly terminate the definition of a block of 
common-relocatable code: CEND, PSEG, DSEG, AORG, and END. The block is 
normally terminated with a CEND directive. The PSEG directive, like CEND, 
indicates that succeeding locations are program-relocatable. The DSEG and 
AORG directives effectively terminate the common segment by beginning a data 
segment or an absolute segment. The END directive terminates the common 
segment and the program. 


CSEG 


Example 


Common Segment Directive CSEG 


COM1IA CSEG "ONE ' 
* COMMON RELOCATABLE SECTION, NAMED 'ONE' 


CEND 
* 
COM2A CSEG ‘TWO! 


* COMMON-RELOCATABLE SECTION, NAMED 'TWO!' 


COM2B CEND 
COM1C CSEG ‘ONE! 


COM1B CEND 
* 


COM1L DATA COM1B-COMI1A LENGTH OF SEGMENT 'ONE' 
COM2L DATA COM2B-COM2A LENGTH OF SEGMENT 'TWO' 


This example illustrates the use of CSEG and CEND. The three blocks of code 
between CSEG and CEND are common-relocatable. The first and third blocks 
are relocatable with respect to one common relocation counter; the second is 
relocatable with respect to another. The first and third blocks constitute the 
common segment ‘ONE’; the value of the symbol COM1L is the number of words 
in this segment. The symbol COM2A is the symbolic address of the first word 
of common segment ‘TWO’; COM2B is the common-relocatable (type ‘TWO’) 
word address of the location following the segment. (Note that the symbols 
COM2B and COMIC are of different relocation types and possibly different 
values.) The value of the symbol COM2L is the number of words in common 
segment ‘TWO’. 


DATA 


Syntax 


Description 


Example 
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Initialize Word Directive DATA 


[<label>] DATA <exp>[,<exp>] [<comment>] 


When used, a label is assigned the location where the assembler places the first 
word. 


DATA places one or more values in one or more successive words in program 
memory. The assembler evaluates each expression and places the value in a word 
as a 16-bit two’s-complement number. 


DATA should be used to place coefficients or other data words in program 
memory. During TMS320C25 execution, TBLR can be used to transfer the data 
words from program memory to data RAM. As many operands as desired may 
be used up to a total line length of 60 characters. 


KONS1 DATA 3200,1+'AB',-'AF' ,>F4A0, 'A' 


DATA initializes five words, starting with a word at location KONS1. The contents 
of the resulting words are >OC80, >4143, >BEBA, >F4A0, and >0041. 


DEF External Definition Directive DEF 


Syntax [<label>] DEF <symbol>[,<symbol>] [<comment>] 
When used, a label is assigned the current value of the location counter. 


Description DEF makes one or more symbols available to other programs. All symbols used 
in the DEF statement must be defined in the same module. Each symbol defined 
in a program module and required by other program modules must be placed in 
the operand field of a DEF directive. A program named ‘ROUTINES’ that DEFs 
a routine named ‘SUBR1’ is shown below. The label ’SUBR1’ must be defined 
in the program. 


LUT "ROUTINES ' 
DEF SUBR1,SUBR2 


SUBR1 EQU S 
RET 
SUBR2 EQU $ 
RET 
END 
Example 1 DEF ENTER,ANS 


This example causes the assembler to include symbols ENTER and ANS in the 
object code; these symbols are available to other programs. 


Example 2 0001 0000 ABC EQU 0 
0002 0001 DEF EQU i 
0003 0000 AOMG - O 
0004 DEF ABC, DEF 
0005 END 


NO ERRORS, NO WARNINGS 
The object code for the above example is: 
KOOOONOSIDT 60000ABC 60001DEF 7F89AF 2.1 83.074 NOSIDT 1 


The symbol name follows the four-digit hexadecimal numbers assigned to the 
symbol by EQU. The number 6 preceding the 4-digit hexadecimal number is an 
object code tag. 
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DEND Data Segment End Directive DEND 


Syntax [<label>] DEND [<comment>] 
When used, a label is assigned the value of the location counter prior to modifi- 
cation. 

Description 7 DEND terminates the definition of a block of data-relocatable code by placing a 


value in the location counter and defining succeeding locations as program-re- 
locatable. DEND results in setting the location counter to one of these values: 


@ The maximum value attained by the location counter as a result of assembling 
any preceding block of program-relocatable code, or 


@ Zero, if no program-relocatable code has been previously assembled. 


lf encountered in common-relocatable or program-relocatable code, DEND 
functions as a CEND or PEND, and a warning message is issued. Like CEND and 
PEND, DEND is invalid when used in absolute code. 
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DORG Dummy Origin Directive DORG 


Syntax 


Description 


Example 1 


Example 2 


Example 3 


[<label>] DORG <exp> [<comment>] 


The label is assigned the value that the directive places in the location counter. 


DORG defines the succeeding locations as a dummy block or section. When 
assembling a dummy section, the assembler does not generate object code but 
operates normally in all other respects. The result is that symbols that describe 
the layout of the dummy section are available to the assembler during assembly 
of the remainder of the program. Any symbol in the expression must have been 
previously defined. 


When the operand field is absolute, the location counter is assigned the absolute 
value. When the operand is relocatable, the location counter is assigned the 
relocatable value and the same relocation type as the operand. When this occurs, 
space Is reserved in the section that has that relocation type. 


DORG 0 


DORG causes the assembler to assign values relative to the start of the dummy 
section to the labels within the dummy section. 


RORG O 


(code as desired) 


DORG § 


(data segment) 
END 


This example directive defines a data structure for the executable portion 
(procedure division) of a procedure that is common to more than one task. The 
executable portion of the module (following a RORG directive) should use the 
labels of the dummy section as relative addresses. The code corresponding to the 
dummy section must be assembled in another program module. In this manner, 
separate data portions (dummy sections) are available to the procedure portion, 
regardless of the memory area into which the data is loaded. 


CSEG  'COM1' 

DORG ¢ "S$" HAS A COMMON-RELOCATABLE VALUE 
LABl DATA g 

MASK DATA >F000 

CEND 


DORG may also be used with data-relocatable or common-relocatable operands 
to specify dummy data or common segments. In this example, no object code is 
generated to initialize the common segment COM1, but space is reserved. All 
common-relocatable labels describing the structure of the common block 
(including LAB1 and MASK) are available for use throughout the program. 
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DSEG Data Segment Directive DSEG 


Syntax [<label>] DSEG [<comment>] 


When a label is used, it is assigned the data-relocatable value that the directive 
places in the location counter. 


Description DSEG defines succeeding locations as data-relocatable. Either of these values 
is placed in the location counter: 


e The maximum value the location counter can attain as the result of assem- 
bling any block of data-relocatable code, or 


@ Zero, if no data-relocatable code has been previously assembled. 


DSEG defines the beginning of a block of data-relocatable code. The block is 
normally terminated with DEND. If several such blocks appear throughout the 
program, they constitute the data segment of the program. The entire data 
segment may be relocated independently of the program segment at link-edit time. 
This provides a convenient way to separate modifiable data from executable code. 


In addition to the DEND directive, PSEG, CSEG, AORG, and END properly 
terminate the definition of a block of data-relocatable code. PSEG, like DEND, 
indicates that succeeding locations are program-relocatable. CSEG and AORG 
effectively terminate the data segment by beginning a common segment (CSEG) 
or an absolute segment (AORG). END terminates the data segment as well as 
the program. 


Example RAM DSEG START OF DATA AREA 


<Data-relocatable code> 


ERAM DEND 


LRAM EQU ERAM - RAM 


The block of code between DSEG and DEND is data-relocatable. RAM is the 
symbolic address of the first word of this block; ERAM is the data-relocatable 
word address of the location following the code block. The value of the symbol 
LRAM is the length of words in the block. 


Caution: 


The TMS320C25 architecture provides separate data and program 
memory space, which results in two memory segments occupying 
the same address space. Data and program segment code must be 
distinguished. In particular, DATA and TEXT should not be used in 
DSEG to initialize an area within data memory. 


Data memory is volatile RAM and cannot retain information from 
one powerup to the next, so the proper way to initialize memory 
is by the execution of instructions in program memory on powerup. 
BSS or BES can be used within the DSEG to establish the size and 
names of variables, scalers, arrays, etc., in data memory. No other 
directives or instructions should be placed in a DSEG or CSEG. 
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END Program End Directive END 


Syntax [<label>] END [<symbol>] /<comment>/ 


When used, a label is assigned the current value of the location counter. 


Description END terminates the assembly. The last source statement of a program is the END 
directive. Any source statements or blank records following END are considered 
part of the next assembly. 


When used, the operand field contains a program-relocatable or absolute symbol 
that specifies to the link editor the entry point of the program. The entry point is 
the program address where execution of the assembled module begins. When 
the operand field is not used, no entry point is placed in the object code. If the 
entry point symbol is specified in the link control file, it must be REFed; otherwise 
the linker cannot find the entry symbol. 


Example AORG 0 
NOP 
ENTRY NOP 
END ENTRY 


The symbol ENTRY is assigned the value 1 by the assembler. Since ENTRY 
appears as the operand of END, the value of the symbol appears as a four-digit 
hexadecimal character 1, as seen in the sample printout below. 


Sample Printout: 


VALUE OF THE SYMBOL 


KOOOONOSIDT 90000B5500B5500100017F8A3F NOSIDT 
Example AORG >20 
ENTRY NOP 
END ENTRY 


The symbol ENTRY is assigned the value >20. As in Example 1, the value appears 
in the object code following the tag character 1, as shown in the sample printout 
below. 


Sample Printout: 
VALUE OF THE SYMBOL 


KOOOONOS$IDT 90020B5500100207F9C7F NOS$IDT 
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EQU Define Assembly-Time Constant Directive EQU 


Syntax [<label>] EQU <exp> [<comment>] 
The label field contains the symbol to be given a value. 


Description EQU assigns a value to a symbol. <exp> may not contain a symbol appearing 
in a REF directive nor contain forward references. Symbols in the operand field 
must be previously defined. Certain symbols, such as ARO and PAO, have 
predefined values. 


Example 1 SUM EQU AR1 


The EQU directive assigns an absolute value to the symbol SUM, making SUM 
available as a register address. 


Example 2 TIME EQU HOURS 


This example assigns the value of the previously defined symbol HOURS to the 
symbol TIME. When HOURS appears in the label field of a machine instruction 
in a relocatable block of the program, the value is a relocatable value. After 
execution of EQU, the two symbols may be used interchangeably. 
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EXEC Independent Program Segment Directive EXEC 


Syntax [<label>] EXEC <pma> [<comment>] 


When used, a label is assigned the value that the directive places in the location 
counter. 


Description EXEC places the value <pma> in the location counter and defines succeeding 
locations as independently stored program segments. EXEC defines the beginning 
of a block of independent code. The block is terminated by XEND. Directives that 
affect the value in the location counter, such as BSS, cannot be used in the 
program segment defined by EXEC. Use of this type of directive terminates the 
EXEC segment. 


EXEC enables execution of a program segment at its actual loading address. The 
value placed in the location counter is the actual loading address of the inde- 
pendent segment. 


Example EXEC1 EXEC >1F40 


XEND 
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IDT Program Identifier Directive IDT 


Syntax [<label>] IDT ‘<string>’ [<comment>] 


When used, a label assumes the current value of the location counter. 


Description IDT assigns a name to the object module produced. The operand field contains 
the module name <string>, a character string of up to eight characters within 
single quotes. When a character string of more than eight characters is entered, 
the assembler prints a truncation warning message and retains the first eight 
characters as the program name. 


Program modules to be linked by the link editor must include an IDT. The module 
names in the character strings of IDTs should be unique. The <string> on IDT 
is not automatically a DEFed symbol. 


Example 0001 IDT 'EXAMPLE' 
0002 0001 ONE EQU 1 
0003 0002 TWO EQU 2 


IDT assigns the name EXAMPLE to the module being assembled. The module 
name is then printed in the source listing as the operand of IDT and appears in 
the page heading of the source listing. The module name is also placed in the 
object code and is used by the link editor to determine the entry point for the 
module. The entry point must also appear as a symbol in a REF directive. 


Note: 


Uppercase letters and numerals are recommended within the quotes. The 


assembler accepts lowercase letters and special characters, but ROM loaders 
(for example) do not. 
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LIST Restart Source Listing Directive LIST 


Syntax [<label>] LIST [<comment>] 


When used, the label assumes the current value of the location counter. 


Description LIST restores printing of the source listing. LIST is required only when UNL (stop 
source listing) is in effect and causes the assembler to resume listing. LIST is not 
printed in the source listing, but the line counter is incremented. The assembler 
does not print the comment. 


Example LIST 


The printing of the source listing is restored. 
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LOAD 


Force Load Directive LOAD 


Syntax 


Description 


Example 
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[<label>] LOAD <symbol>[,<symbol>] [<comment>] 
When used, a label is assigned the current value of the location counter. 


LOAD makes one or more symbols available to other programs. The LOAD 
directive is like DEF, except that the symbols need not be used in the module 
containing LOAD. The symbols used in LOAD must be defined in some other 
module during link edit time. LOADs are used with SREFs. If a one-to-one 
matching of LOAD and SREF pairs does occur, there will be no unresolved 
references during link editing. 


MODULE A1 MODULE A2 MODULE A3 
LOAD C, D LOAD C LOAD E, F 
MODULE B 


SREF C, OD, EF 
DATA C 


DATA D 
DATA E 
DATA F 


MODULE C MODULE D MODULE E MODULE F 


Module A(n) uses a branch table in module B to obtain one module: either C, 
D, E, or F. Module B has an SREF for C, D, E, and F. SREF does not require that 
symbols C, D, E, and F have corresponding symbols defined in another module, 
so modules need not be included in one link editing time. Module C has a DEF 
for C; module D has a DEF for D; module E has a DEF for E; and module F has 
a DEF for F. Module Ai has a LOAD for modules C and D; module A2 has a LOAD 
for module C; and module A3 has a LOAD for modules E and F. 


LOAD and SREF permit module B to be written to in order to handle a highly 
involved case and still be linked together without unnecessary modules. A(n) 
only has LOAD directives for its required modules. This is especially useful when 
developing large codes that may have more than a hundred modules. Not all 
modules are required to test a particular function. 


If the link control file included A1 and A2, modules C and D would be pulled in 
from a specified library while modules E and F would not. If the link control file 
included A3, modules E and F would be pulled in while modules C and D would 
not. If the link control file included A2, module C would be pulled in while 
modules D, E, and F would not. 


LOAD Force Load Directive LOAD 


TASK TSTLOAD 
FORMAT ASCII 
PROGRAM 0 
INCLUDE E:A1.MPO 
INCLUDE E:B.MPO 
FIND A:*.MPO 

END 


In this example using a PC/MS-DOS computer, the A:*.MPO is a selection of files 
that contain 990-tagged object modules for modules C, D, E, and F. In this case, 
only modules C and D are to be linked into the LOAD object module. 
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MLIB Define MACRO Library Directive MLIB 


Syntax [<label>] MLIB ‘<pathname>’ [<comment>] 


When used, a label assumes the current value of the location counter. 


Description MLIB provides the assembler with the name of a library containing macro defi- 
nitions. The operand of MLIB is a directory pathname (constructed according to 
the conventions of the host operating system) enclosed in single quotes (see IDT 
and TITL directives). The operand field contains the pathname, a character string 
of up to 48 characters enclosed in single quotes; longer strings cause a truncation 
error message. 


Example 1 MLIB 'DRC1: [PROJECT.STDMACS] ' 
MLIB 'DRC1: [PROJECT.DSPMACS] ' 


When the program finds macro call SUBMAC (not previously defined), the above 
example causes the macro to search first for a file named: 


DRC1: [PROJECT .DSPMACS ]SUBMAC.ASM 
Then, if that file is not found, the macro searches for a file named: 
DRC1: [PROJECT.STDMACS ] SUBMAC.ASM 


in that order. 


Example 2 MLIB 'DRCO: [MOORE.MACLIB] .ASM32' (VAX) 
MLIB 'A:' (MS-DOS VER 1.25) 


This example shows the typical use of MLIB on other systems. 


Note: 


On VAX/VMS systems, the filename of all files in the macro library must have 
an extension name of ”".ASM”. For example, if the statement: MLIB 
‘DRC1:[MACROS]’ has been used, the VAX/VMS version of the macro library 
processor would expect to find files such as MYMACRO.ASM, NEWMAC.ASM, 
etc., within the macro library 'MACROS’. 


On PC/MS-DOS systems, the filename of all files in the directory that are to 
be found as macros must not have an extension. For example, if the statement: 
MLIB ‘E:’ has been used, then the PC/MS-DOS version of the macro library 
processor would expect to find files such as MYMACRO, NEWMAC, etc., within 
the current level directory. 
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OPTION 


Syntax 


Description 


Example 


utput Options Directive PTION 


[<label>] OPTION <option list> [<comment>] 


When used, the label assumes the current value of the location counter. 


OPTION selects several options for the assembler listing output. The <option- 
list> operand is a list of keywords, separated by commas, where each keyword 
selects a listing feature. The available <option-list> features are as follows: 


DUNLST: Limit the listing of DATA directives to one line. 
FUNLST: Turn off all list options. 

NOLIST: Inhibit all listing output (overrides LIST directive). 
SYMLST: Produce a symbol table list in the object file. 
TUNLST: Limit the listing of TEXT directives to one line. 


XREF: Produce a symbol cross-reference listing. 


OPTION XREF 


This example results in the production of a symbol cross-reference listing. 
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PAGE Eject Page Directive PAGE 


Syntax 


Description 


Example 
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[<label>] PAGE [<comment>] 


When used, a label assumes the current value of the location counter. 


PAGE causes the assembler to continue the source program listing on a new page. 
PAGE is not printed in the source listing, but the line counter is incremented. 
The assembler does not print the comment. Using PAGE to divide the source 
listing into logical divisions improves program documentation. 


PAGE 


PAGE causes the assembler to list a next source statement as the first statement 
on a new page in the source listing. 


PEND Program Segment End Directive PEND 


Syntax [<label>] PEND [<comment>] 
When used, a label is assigned the value of the location counter prior to modifi- 
cation. 

Description PEND ends a segment that is program-relocatable. This directive is provided as 


the program-segment counterpart to DEND and CEND. PEND, like DEND and 
CEND, places a value in the location counter and ends a segment that has defined 
succeeding locations as program-relocatable. Since PEND properly appears only 
in program-relocatable code, the relocation type of succeeding locations remains 
unchanged. 


The value placed in the location counter by PEND is the maximum value attained 
by the location counter as a result of the assembly of all preceding program-re- 
locatable code. PEND is invalid when used in absolute code. 


Example See PSEG. 
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PSEG Program Segment Directive PSEG 


Syntax [<label>] PSEG [<comment>] 


When used, a label is assigned the value that the directive places in the location 
counter. 


Description PSEG places a value in the location counter and defines succeeding locations as 


program-relocatable. The location counter is set to one of the following values: 


@ The maximum value the location counter attained as a result of the assembly 
of any preceding block of program-relocatable code, or 


@ Zero, if no program-relocatable code was previously assembled. 


PSEG is provided as the program-segment counterpart to DSEG and CSEG. 
Together, the three directives provide a consistent method of defining the various 
types of relocatable segments. 


Example The following two sequences of directives are functionally identical: 
SEQUENCE 1 SEQUENCE 2 
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DSEG 
<Data-relocatable code> 


DEND 
CSEG 


<Common-relocatable code> 


CEND 


DSEG 
<Data-relocatable code> 
CSEG 


<Common-relocatable code> 


PSEG PSEG 
PEND 
END END 


REF 


Syntax 


Description 


Example 


External Reference Directive REF 


[<label>] REF <symbol>[,<symbol>] [<comment>] 


When used, a label is assigned the current value of the location counter. 


REF provides access to one or more symbols defined in other programs. Each 
symbol from another program module must be placed in the operand field of REF 
or SREF in the program module that requires the symbol. Below is a program 
named ‘MAIN’ that REFs a routine named ‘SUBR1’. SUBR’7 is not defined in this 
file. 


IDT ‘MAIN! 
REF SUBR1 
CALL SUBR1 
END 


If a symbol is listed in the REF statement, a corresponding symbol must also be 
present in a DEF statement in another source module. If a one-to-one matching 
of symbols does not occur, then an error occurs at link edit time. The link editor 
generates a summary list of all unresolved references. 


REF ARG1,ARG2 


This example causes the assembler to include symbols ARG1 and ARG2 in the 
object code so that the corresponding addresses may be obtained from other 
programs. 
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RORG Relocatable Origin Directive RORG 


Syntax [<label>] RORG [[<exp>] /<comment>/] 


When a label is used, it is assigned the value that the directive places into the 
location counter. 


Description RORG defines succeeding locations as program-relocatable and initializes the 
location counter to either the value following the previous relocatable code of the 
program or to zero if no relocatable code has been previously assembled. 


Since the location counter begins at zero, the length of a segment and the next 
available address within that segment are identical. For example, if a segment 
begins at >O and ends at >E, the length is >F. The next available address is >F. 


When the operand field is used, the operand must be an absolute or a relocatable 
expression that contains only previously defined symbols. (Symbols are defined 
by the EQU directive.) When the operand field is not used, previous data segments 
and specific common segments of a program replace the value of the location 
counter. If RORG appears in absolute code, a relocatable operand must be 
program-relocatable. RORG changes the location counter to program-relocatable 
and replaces its value with the operand value. In relocatable code, the relocation 
type of the operand must match that of the current location counter. The operand 
value replaces the current location counter value, and the relocation type of the 
location counter remains unchanged. 


Example 1 RORG $-10 OVERLAY TEN WORDS 


The $ symbol refers to the present location counter value. This has the effect of 
backing up the location counter by ten words. The instructions and directives 
following RORG replace the ten previously assembled words of relocatable code, 
permitting correction of the program without removing source records. If a label 
had been included, the label would have been assigned the value placed in the 
location counter. RORG would have no effect except at the end of an absolute 
block or a dummy block. 


Example 2 SEG2 RORG 


The location counter contents depend upon preceding source statements. 
Assume that after defining data for a program that occupied >44 words, AORG 
initiated an absolute block of code. The absolute block is followed by the RORG 
directive from Example 1. This places >0044 in the location counter and defines 
the location counter as relocatable. Symbol SEG2 is a relocatable value, >0044. 
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SREF Secondary External Reference Directive SREF 


Syntax [<label>] SREF <symbol>[,<symbol>] [<comment>] 


When a label is used, the current value of the location counter is assigned to the 
label. 


Description SREF provides access to one or more symbols defined in other programs. Unlike 
REF, SREF does not require that a symbol have a corresponding symbol listed in 
a DEF statement of another source module. The SREFed symbol will be an 
unresolved reference, but is not included in the summary list of unresolved refer- 
ences. 


Example SREF ARG1,ARG2 


This example causes the assembler to include symbols ARG1 and ARG2 in the 
object code so that the corresponding addresses may be obtained from other 
programs. 
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TEXT 


Initialize Text Directive TEXT 


Syntax 


Description 


Example 
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[<label>] TEXT [-]’<string>’ [<comment>] 


When used, a label is assigned the location at which the assembler places the first 
character. 


TEXT places one or more characters of a string of characters in successive words 
of program memory. The assembler negates the last character of the string when 
the string is preceded by a unary minus (-) sign. The operand field contains a 
character string of up to 52 characters enclosed in single quotes, which may be 
preceded by a unary minus sign. 


MSG1 TEXT 'EXAMPLE' MESSAGE HEADING 


In this example, TEXT places the eight-bit ASCII character representations in 
memory and fills the unused byte of the last word with an ASCII space (>20). 
This space is considered as the last character if the negate option is specified. 
The result is >4558, >414D, >504C, and >4520. The label MSG1 is assigned 
the first word’s address, which contains the value >4558. 


TITL Page Title Directive TITL 


Syntax 


Description 


Example 


[<label>] TITL ‘<string>’ [<comment>] 


When used, a label field assumes the current value of the location counter. 


TITL supplies a title to be printed in the heading of each page of the source listing. 
Unlike IDT, TITL is not printed in the source listing. When a title is desired in the 
heading of the listing’s page, TITL must be the first source statement submitted 
to the assembler. The assembler does not print the comment because TITL is not 
printed. The line counter is incremented. 


The operand field contains the title (string) and a character string of up to 50 
characters enclosed in single quotes. When more than 50 characters are entered, 
the assembler retains the first 50 characters as the title and prints a syntax error 
message. 


When TITL is the first source statement in a program, the title is printed on all 
pages until another TITL is processed. Otherwise, the title is printed on the next 
page after TITL is processed, and on subsequent pages until another TITL is 
processed. 


TITL '**REPORT GENERATOR**'! 


This example causes the title **REPORT GENERATOR" to be printed in the page 
headings of the source listing. 
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UNL Stop Source Listing Directive UNL 


Syntax 


Description 


Example 
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[<label>] UNL [<comment>] 


When used, the label assumes the value of the location counter. 


UNL halts the source listing output until the occurrence of a LIST directive. UNL 
is not printed in the source listing, but the source line counter is incremented. 
UNL is frequently used in macro definitions to inhibit the listing of the macro 
expansion. The assembler does not print the comment. 


UNL can be used to reduce assembly time and the size of the source listing. 


NOPRINT UNL STOP LISTING 


The source listing is halted until a LIST directive occurs. 


XEND independent Segment End Directive XEND 


Syntax [<label>] XEND [<comment>] 


When used, a label is assigned the value placed in the location counter by the 
XEND directive. 


Description XEND terminates the block definition of an independently stored program 
segment, previously defined by EXEC. The command field contains XEND. XEND 
results in setting the location counter to the value attained by the location counter 
before EXEC was issued, plus the difference between the most recent value in the 
location counter and the loading address of EXEC. 


Without using EXEC, a warning message is issued. 


Example See EXEC. 
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7.8 Source Listing Format 
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The source listings show the source statements and the resulting object code. Each 
page of the source listing has a title line at the top, on which is printed a title supplied 
by a TITL (title) directive. If TITL is not used, the title line is left blank. A page number 
is printed to the right of the title. The printer inserts a blank line below the title line 
and prints a line for each source statement listed. 


Each source statement line contains a source statement number, a location counter 
value, the assembled object code, and the source statement as entered. A source 
statement may result in more than one word of object code. The assembler prints the 
location counter value and object code on a separate line for each additional word. 
Each added line is printed immediately following the source statement line. Figure 
7-1 is an example of a source statement line. 


(SOURCE STATEMENT NUMBER IN DECIMAL) 
(LOCATION COUNTER VALUE IN HEXADECIMAL) 
(ASSEMBLED OBJECT CODE IN HEXADECIMAL) 
(LABEL FIELD) 
(COMMAND FIELD) 
(OPERAND FIELD) 
(COMMENT FIELD) 


| 


0070 004A CAFF BEGIN LACK 255 LOAD ACCUMULATOR IMMEDIATE 


Figure 7-1. Source Statement Line Example 


The source statement number, 0070 in the example, is a four-digit decimal number. 
Source records are numbered in the order in which they are entered, including those 
source records that are not listed (e.g., TITL, LIST, UNL, and PAGE directives are 
not listed; source records between UNL and LIST are not listed). The difference 
between two source record numbers printed immediately in line indicates the number 
of source records entered and not listed. Source records generated by a macro call, 
however, are renumbered starting at line number 0001. The original line-numbering 
sequence continues after the macro expansion is complete. 


The next field in the source listing contains a hexadecimal location counter value. 
In the example, 004A is the location counter value. Since not all directives affect the 
location counter, the location counter field is blank for those directives that do not 
affect it, such as the IDT (program identifier), DEF (external definition), END 
(program end), EQU, REF, and SREF directives. 


The third field is the object code field which contains the hexadecimal representation 
of the object code, (>CAFF in the above example). All machine instructions and the 
DATA and TEXT directives use this field to list object code. The EQU directive places 
the value corresponding to the label in the object code field. 


The fourth field contains the characters of the source statement as they were scanned 
by the assembler. The maximum line length that the assembler will accept is 60 
characters. Spacing in this field is determined by the spacing in the source statement. 
The four fields contained in source statements are aligned in the listing only when 
they are aligned in the source statements or when tab characters are used. Each of 
the four fields must be separated by at least one blank space. 
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7.9 Object Code 


KOOQOOFACT 


A major advantage of the TMS320C25 Macro Assembler is its ability to generate 
relocatable object code modules that can then be linked by the link editor to form 
an executable program. The ability to relocate modules simplifies the programming 
task. Programs designed as a set of modules are easier to code, test, and debug, and 
are also easier to understand and maintain. Relocatability also permits multiple 
programmers to work on a program’s components. Relocatable code includes 
information that allows a link editor to place the code in any available area of memory, 
thus providing the most efficient use of available memory. Absolute code must be 
loaded into a specified area of memory and cannot be moved. 


Object code generated by an assembler constitutes the assembled program, and 
consists of machine language instructions, addresses, and data. The code includes 
absolute, program-relocatable, data-relocatable, and common-relocatable segments. 


In assembly language source programs, symbolic references to locations within a 
relocatable segment are called relocatable addresses. These addresses are repres- 
ented in the object code as displacements from the beginning of a specified segment. 
A program-relocatable address, for example, is a displacement into the program 
segment. At load time, all program-relocatable addresses are adjusted by a value 
equal to the load address (the load address defines the beginning of the module). 
Data-relocatable addresses are represented by a displacement into the data segment. 
There may be several types of common-relocatable addresses in the same program, 
since distinct common segments may be relocated independently of each other. 


The assembler produces object code that may be linked to other object code modules 
Or programs, and is loaded directly into the processor. Object code consists of records 
containing up to 71 ASCII characters. Corrections on record data can be made via 
a keyboard, making reassembly unnecessary. Figure 7-2 is an example of object code. 


91006BCA0N1B6000BCAN1B6001BCA02B6002BCA03B6003B3C037F240F FACT 


BAOO2BCE14B600 3BCA04B6004B3CO4BA003BCE14B6004B3CO4BA003BCE14B60047F16BF FACT 
BCAO5B6005B3CO5BA004BCE14B6005B3CO5BA003BCE14B6005B3CO5BA002BCE147F151F FACT 
BEOO5BCAD6BE006B3CO6BAODO5BCE14B6006B3CO6BAOD04BCEL14B6006B3CO6BA0037F169F FACT 
BCE14B6006B3CO6BA002BCE14B6006BCA0N7B6007B3CO7BAOO6BCE14B6007B3CO77F14BF FACT 
BAOO5BCE14B6007B3C07BAO04BCE14B6007B3CO7BAOO3BCE14B6007B3CO7BA0027F158F FACT 
BCE14B60077FD8BF FACT 
: FACT 8/7/84 16:42:51 ASM32020 0.6 84.140 FACT 


Figure 7-2. Sample Object Code 


7.9.1 Object Code Format 


Object code is formatted to contain records made up of fields sandwiched between 
tag characters. Table 7-8 lists field and tag character information. 


A tag character occupies the first position on each record of object code and identifies 
the fields it precedes. The specific tag character used depends on the function of the 
field with which it is associated. The following paragraphs detail the various tag 
characters and their associated fields. 


Tag character K is placed at the beginning of each program and is followed by two 
fields. Field one contains the number of words of program relocatable code; field two 
contains the program identifier assigned to the program by an IDT directive. When 
no IDT is entered, NOSIDT is put into field two. The link editor uses the program 
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identifier to identify the program, and the number of words of program-relocatable 
code to determine the load bias for the next module or program. 


The tag character M is used when data or common segments are defined in the 
program and is followed by three fields. Field one contains the length, in words, of 
data- or common-relocatable code; field two contains the data or common segment 
identifier; and field three contains a common number. The identifier is a six-character 
field containing the name $DATA (padded on the right by one blank) for data 
segments and $BLANK for blank common segments. If a named common segment 
appears in the program, an M tag appears in the object code, with an identifier field 
corresponding to the operand in the defining CSEG directive(s). Field three of the 
M tag consists of a four-character hexadecimal number defining a unique common 
number to be used by other tags referencing or initializing data of that particular 
segment. For data segments, this common number is always zero. For common 
segments (including blank common), common numbers are assigned in increasing 
order. The maximum number of common segments that a program may contain is 
tae. 


Tag characters 1 and 2 are used with entry addresses. The associated field is used 
by the linker to determine the entry point where execution starts when linking is 
complete. Tag character 1 is used when the entry address is absolute; tag character 
2 is used when the address is relocatable. The field lists the address in hexadecimal. 


Tag characters 9, A, S, and P are used with load addresses required for data words 
to be placed at other than the next immediate memory addresses. Tag character 9 is 
used when the load address is absolute; A when the load address is program-relo- 
catable; S when the load address is data-relocatable; and P when the load address 
is common-relocatable. Field one contains the load address. Field two is only used 
with P and contains the common number. 


Tag characters B, C, T, and N are used with data words. Tag character B is used 
when the data is absolute (i.e., an instruction word or a word containing text char- 
acters or absolute constants). B is used for absolute word data (16 bits). Tag 
character C is used for a word containing a program-relocatable address; tag char- 
acter T for a word containing a data-relocatable address; tag character N for a word 
containing a common-relocatable address. Field one contains the data word. The 
linker places the data word in the memory location specified in the preceding load 
address field or in the memory location that follows the preceding data word. Field 
two is only used with N and contains the common number. 


Tag characters #, %, and & are also used when an instruction’s multibit field refers 
to a data element in a DSEG, PSEG, or CSEG. Tag character # identifies an instruction 
containing a reference to a multibit data-relative item. The second field following 
the tag contains a mask indicating to the link editor the width of the field (mask = 
>007F indicates the least significant 7 bits). The link editor generates the final version 
of this instruction by adding the beginning location of the data segment to the 
masked data word, and re-inserting the sum in the multibit field within the data word. 
Note that field overflow may occur in the link edit operation, and error messages 
may be generated that were not evident at assembly time, which may give unpre- 
dictable results. The description of the % tag is the same as above, except that it 
represents the use of a program-relative item as the operand. The fields used with 
the & tag are identical to the # and % tags, except that the second field is the common 
number, and the mask becomes the third field. 


Tag characters 5, 6, and W are used for external definitions. Tag character 5 is used 
when the location is program-relocatable; 6 when the location is absolute; and W 
when the location is data- or common-relocatable. The link editor uses the fields 
to provide the desired linking to the external definition. Field one contains the 
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location of the last appearance of the symbol; field two contains the symbol of the 
external definition; and field three of tag character W contains the common number. 


Tag character 4 is used for external references when the last appearance of the 
externally referenced symbol is in absolute code. Tag character 4 is associated with 
two fields: field one contains the location of the last appearance of the symbol, and 
field two contains the symbol itself. 


Tag character E is used for external references. An E tag is used when a non-zero 
quantity is added to a reference. Field 1 identifies the reference by occurrence in the 
object code (0, 1, 2, ...). In other words, the value in field one is an index to references 
identified by the 4 and Y tags in the object code. The list is maintained by order of 
occurrence (i.e., the first entry in the list is the symbol located in field two of the first 
4 or Y tag). Field 2 contains the value to be added to the reference after the reference 
is resolved. 


Tag character ! is used when a multibit field of an instruction refers to an external 
reference. The format of the ! sequence is: 


! (external symbol number) (opcode/offset) (mask) 
This tag and its associated fields are processed the same as that of the # tag. 


Tag characters G, H, and J are used when the symbol table option (see the OPTION 
directive) is specified. Tag character G is used when the location or value of the 
symbol is program-relocatable; H when the location or value of the symbol is abso- 
lute; and J when the location or value of the symbol is data- or common-relocatable. 
Field one contains the location or value of the symbol; field two contains the symbol 
to which the location is assigned; field three is used only with tag character J and 
contains the common number. 


Tag character U is generated by the LOAD directive. The symbol specified is treated 
as if it were the value specified in an INCLUDE command to the loader. Field one 
contains zeroes, and field two contains the symbol for which the loader will search 
for a definition. 


Tag character Y is used for secondary external references when the last appearance 
of the externally referenced symbol is in absolute code. Tag character Y is associated 
with two fields: field one contains the location of the last appearance of the symbol, 
and field two contains the symbol itself. 


Tag character 7 precedes the checksum, and is placed at the end of the set of fields 
in the record. The checksum is an error detection word formed as the record is being 
written. The checksum is the two’s complement of the sum of the characters’ 8-bit 
ASCII values from the first tag of the record through the checksum tag (tag character 
‘oF 


Tag character 8 is also associated with the checksum field but is used when the 
checksum field is to be ignored (as when changing the object code). 


Tag character D, used to specify a load bias, has an associated field containing the 
absolute address used by the loader to relocate symbols. The link editor does not 
accept the D tag. 


Tag character F is placed at the end of the record, and it may be followed by blanks. 


The end of each record is identified by the tag character 7, followed by the checksum 
field and tag character F. The assembler fills the rest of the record with blanks and 
a sequence number, and begins a new record with the appropriate tag character. 
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The last record of an object module has a colon (:) in the first character position of 
the record, followed by the module name, assembly date, and assembly time. 


Table 7-8 defines the object record format and tags. 


Table 7-8. Object Record Format and Tags 


TAG 1ST FIELD 2ND FIELD 3RD FIELD 


(MODULE DEFINITION) 


PSEG LENGTH PROGRAM I!D(8) 

DSEG LENGTH SDATA 0000 
BLANK COMMON SBLANK COMMON # 
LENGTH 

CSEG LENGTH COMMON NAME(6) COMMON # 


(ENTRY POINT DEFINITION) 


ABSOLUTE ADDRESS 
P-R ADDRESS 
(LOAD ADDRESS) 


ABSOLUTE ADDRESS 

P-R ADDRESS 

D-R ADDRESS 

C-R ADDRESS COMMON # 


(DATA WORD) 


ABSOLUTE 16-BIT 

VALUE 

P-R ADDRESS 

D-R ADDRESS 

C-R ADDRESS COMMON # 
OPCODE/DR ADDRESS MASK 
OPCODE/PR ADDRESS MASK 


OPCODE/CR ADDRESS COMMON # 
(EXTERNAL DEFINITIONS) 


ABSOLUTE VALUE SYMBOL(6) 
P-R ADDRESS SYMBOL(6) 
D-R/C-R ADDRESS SYMBOL(6) COMMON # 


(EXTERNAL REFERENCES) 


ABSOLUTE ADDRESS SYMBOL (6) 

OF CHAIN 

SYMBOL INDEX ABSOLUTE OFFSET 
NUMBER 

SYMBOL INDEX OPCODE/OFFSET 
NUMBER 


(SYMBOL DEFINITIONS) 


P-R ADDRESS SYMBOL(6) 
ABSOLUTE VALUE SYMBOL(6) 
D-R/C-R ADDRESS SYMBOL(6) COMMON # 
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Table 7-8. Object Record Format and Tags (Concluded) 


. 
OF CHAIN 

Hal MALE eldnsec rh Thaw w lot sido a Tage 

RARY VAGUE S087 30 Tow Spprener viene reeROnTOnE 

fapecugempoges 9 fo 

2 SER 

1 [PRADDRESS «| PROGRAMID@). PS 


e 


NOTES: 1. All field widths are four characters unless otherwise specified. 
' If the first tag is >01, the file is in compressed object format. 
a. P-R denotes program segment, relative address. 


D-R denotes data segment, relative address. 
C-R denotes common segment, relative address. 


7.9.2 Changing Object Code 


Object code may be corrected without reassembling a program by changing or adding 
one or more records. One additional tag character is recognized by the loader to 
permit specifying a load point. The additional tag character, D, may be used in object 
records changed or added manually. 


Tag character D is followed by a load bias (offset) value. The loader uses this value 
instead of the load bias computed by the loader itself. The loader adds the load bias 
to all relocatable entry addresses, external references, external definitions, load 
addresses, and data. The effect of tag character D is to specify that area of memory 
into which the loader loads the program. The tag character D and the associated field 
must be placed ahead of the object code generated by the assembler. 


Correction of the object code may only require changing a character or a word in 
an object code record. Records may be duplicated up to the character or word in error. 
Then the correct data replaces the incorrect data, and the remainder of the record 
up to tag character 7 is duplicated. When the checksum is verified as the record is 
loaded, the changes made cause a checksum error. The tag character 7 should be 
changed to 8. This causes the checksum error resulting from the record change to 
be ignored. 


When more extensive changes are required, an additional object code record(s) may 
be written. Each record is begun with a tag character 9, A, S, or P (load address tag 
characters), followed by an absolute load address or a relocatable load address. This 
may be an address into which an existing object code record places a different value. 
The new value on the new record overrides the old value when the new record 
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follows the old record in the loading sequence. The load address is followed by a 
tag character B, C, T, or N (data word tag characters) and an absolute data word 
or a relocatable data word. Additional data words preceded by appropriate tag 
characters may follow. When additional data is placed at a nonsequential address, 
another load address tag character is written followed by the load address and data 
words preceded by tag characters. When the record is full, or all changes have been 
written, tag character F is written to end the record. 


When additional memory locations are loaded as a result of changes, field one of tag 
character K containing the number of words of relocatable code must be changed. 
For example, if the object field written by the assembler contained 1000 hexadecimal 
words of relocatable code and the change has added eight words in a new object 
record, additional memory locations will be loaded. In the object code file, the value 
following the tag character K is changed from 1000 to 1008. The tag character 7 is 
also changed to 8 in that record. 


When added records place corrected data in locations previously loaded, the added 
records must follow the incorrect records. The loader processes the records as they 
are read from the object medium. The last record that affects a given memory location 
determines the contents of that location at execution time. 


The object code records that contain the external definition fields, the external 
reference fields, the entry address field, and the final program start field, must follow 
all other object records. An additional field or record may be added to include 
reference to a program identifier. The tag character is 4, and the hexadecimal field 
contains zeros. The second field contains the first six characters of the |IDT character 
string. External definitions may be added using tag character 5 or 6, followed by the 
relocatable or absolute address, respectively. The second field contains the defined 
symbol, filled to the right with blanks when the symbol contains less than six char- 
acters. 


7.10 Cross-Reference Listing 


The assembler prints an optional cross-reference listing following the source listing. 
(The cross-reference listing is created by using the OPTION directive.) The format 
of the listing is shown in Figure 7-3. 


LABEL VALUE DEFN REFERENCES 


BASE2 029B 0095 

BC 0236 0009 0003 0025 0030 0035 0060 0061 0064 0067 0069 
BCDONE REF 0004 0082 0084 0086 0088 0090 0092 0094 
Cte O023B 0014 0020 0079 

CTXT1 OZsC -O015° OUei OUO77 

CTAT2 O23D 0016 0022 0078 

IORT SREF  O0O0S 

IORT1B UNDF 0039 0043 

IORTIF 0256 0040 0028 

IORT2F O025B 0044 0036 

LORZTSF .O0281:.. 00:76.:0072 

LORTBL O2Z98. 0093. .0058 

LORTE2 UZSS" “OUST” -Gus5 

IGETB3S. Q292 - 0089  - 0052 

IORTB4 O28F 0087 0049 


Figure 7-3. Cross-Reference Listing Format 
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As shown in Figure 7-3, the assembler prints in the LABEL column each symbol 
defined or referenced in the assembly. The VALUE column contains a four-digit 
hexadecimal number and is possibly followed by either a character or a name that 
represents the attributes of the symbol. A four-digit hexadecimal number represents 
the value assigned to the symbol. The characters following the four-digit number or 
the names that may be in the VALUE column have their meanings listed in Table 7-9. 
The number of the statement in which the symbol is defined appears in the DEFN 
(definition) column. For undefined symbols, this column is left blank. The REFER- 
ENCES column lists the number of statements that reference the symbol. A blank in 
this column indicates the symbol was defined but never used. 


Table 7-9. Assembly Symbol Attributes 


CHARACTER 
OR NAME 


External reference (REF) 
Undefined 

Secondary reference (SREF) 

Symbol defined in a program segment 
Symbol defined in a data segment 
Symbol defined in a common segment 


7.11 Assembler Error Messages 
The assembler issues the following three types of error messages: 


* Nonfatal 
€ Fatal 
® Informative 


When the assembler completes an assembly, it indicates any errors it encounters in 
the assembly listing. The assembler indicates errors following the source line in which 
they occur. The errors are referenced by number. At the end of a module (as delin- 
eated by the IDT/END directive pair), the corresponding messages are printed. Table 
7-10 lists non-fatal error messages, and Table 7-11 lists fatal messages. In Table 
7-12, assembly information messages are given. 
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Table 7-10. Non-Fatal Error Listing 


[message —~—=«S=Si*=“‘*‘“‘SCS™SCCOEXPLANATIONTRESPONSE SS 


WARNING - 'DSEG’ ASSUMED This is a warning that the following two statements have the same result: 
CSEG '‘'DATA' 
DSEG 


WARNING - SYMBOL TRUNCATED The maximum length for a symbol is 6 characters. The assembler ignores the 
extra characters. 

WARNING - STRING TRUNCATED Check the syntax for the directive question to determine the maximum length 
for the string. 

WARNING - TRAILING OPERAND(S) The assembler found fewer or more operands than expected in the flagged 
instruction. 

WARNING - BYTE VALUE TRUNCATED | A value to be used as a byte is larger than can be loaded into the space for a 
byte. 

WARNING - NULL STRING DEFINED An empty string (i.e., length = 0) is defined for string input, for directives 
that require a null string operand. 
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Table 7-11. Fatal Error Listing 


EXPLANATION/RESPONSE 


ABSOLUTE VALUE REQUIRED A relocatable symbol was used where an absolute symbol was 
expected. 


DISPLACEMENT TOO BIG The maximum value of the operand was exceeded. 
INVALID EXPRESSION This may indicate invalid use of a relocatable symbol in arithmetic. 
EXPRESSION OUT OF BOUNDS Range limit for the value of the operand was exceeded. 


DUPLICATE DEFINITION The symbol appears as an operand of a REF statement, as well as 


in the the label field of the source, or the symbol appears more than 
once in the label field of the source. 


INVALID RELOCATION TYPE An absolute variable cannot be made relocatable. 

INVALID OPCODE The command field of the source record has an entry that is not a 
defined instruction, directive, or macro. 

INVALID OPTION The option given in the OPTION directive is invalid. An option is 
often misspelled. 

INVALID REGISTER VALUE The register specified is too large or too small. Only values of 0 to 
4 are allowed for ARO to AR4, respectively. 


INVALID SYMBOL The symbol has invalid characters in it. 


VALUE TRUNCATED The value is too big for the field and has been truncated. This 


message also appears when a label string exceeds its maximum 
length. 


SYMBOL USED IN BOTH REF AND DEF 
COPY FILE OPEN ERROR File does not exist or is already being used. 


EXPRESSION SYNTAX ERROR Unbalanced parentheses or invalid operations on relocatable 
symbols. 

INVALID ABSOLUTE CODE DIRECTIVE The directives PEND, DEND and CEND have no meaning in abso- 
lute code. 


LABEL REQUIRED The flagged directive must have a label. 
BLANK MISSING A blank or blanks must separate each field of the source statement. 


COMMA MISSING Expected a comma but did not find one. Usually means that more 
operands were expected. 


COPY FILENAME MISSING Filename specified cannot be found. 


SYMBOL REQUIRED OPTION, DEF, REF, SREF, and LOAD directives require symbols 
as operands. 


An operand must be supplied. 

All strings must be enclosed in quotes. 
Mismatched parenthesis. 

TEXT directive used with no text following. 


PASS1/PASS2 OPERAND CONFLICT A symbol in the symbol table did not have the same value in PASS1 
and PASS2. 


SYNTAX ERROR Error in syntax. 


UNDEFINED SYMBOL The symbol has not been REFed, or it has been DEFed but not 
used. 


DIVIDE BY ZERO An expression or well-defined expression contains invalid division. 
ILLEGAL SHIFT COUNT The shift count requested is not valid. 
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Table 7-12. Assembly Information Message Listing 


imameic 9 SS crreres EXPLANATION/ RESPONSE 


OPCODES REDEFINED As a result of an MLIB directive, one or more assembler opcodes 


have been redefined by a MACRO within a MACRO directory. The 
MACROS REDEFINED 


user should take action if this is not intended. 


As a result of an MLIB directive, one or more currently defined 
MACROS have been redefined by a MACRO (of the same name) 
within a MACRO directory. The user should take action if this is 
not intended. 
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8. Assembler Macros 


The TMS320C25 Macro Assembler supports macro calls and definitions along with 
macro-conditional assembly for simplifying programming and _ consolidating 
frequently repeated source code. Macros may be defined with the assembler input 
or in a library (directory) of external files to be included at link time. 


Major topics discussed in this section are listed below. 


e Macro Definitions (Section 8.1 on page 8-2) 
Sample macros 
Macro assembly language elements: 
- Labels (Section 8.2 on page 8-5) 
- Strings (Section 8.3 on page 8-5) 
- Constants (Section 8.4 on age 8-5) 
- Variables (Section 8.5 on page 8-5) 
- Operators (Section 8.6 on page 8-9) 
- Keywords (Section 8.7 on page 8-10) 
- Verb statements (Section 8.8 on page 8-11) 


’ Model Statements (Section 8.9 on page 8-17) 
@ Macro Examples (Section 8.10 on page 8-18) 


a Macro Error Messages (Section 8.11 on page 8-20) 
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8.1 Macro Definitions 
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The TMS320C25 Macro Assembler recognizes a macro definition language that is 
used to simplify programming. A macro definition is a set of source statements 
(machine instructions, macro statements, and assembler directives), which constitute 
a template for generating other statements within a source program. Macro defi- 
nitions consist of model statements and statements containing macro verbs. They 
are used to define macros and macro variables and to determine which model 
statements are assembled. 


When the assembler processes a macro call, it substitutes the predefined statements 
of the macro definition for the macro call statement in the source program, and 
assembles the substituted statements as if they had been included in the source 
program. 


Macro definitions are usually created by including lines of code in a predefined format 
within the assembler source file. In general, this format requires a symbolic line 
marking the start of a macro definition. The macro name is placed in the line’s label 
field, and the string ‘SMACRO’ is placed in the operand field. A list of formal 
parameters separated by commas may be placed in the operand field. 


The elements of the macro assembly language are labels, strings, constants, variables, 
operators, keywords, and verbs. A macro definition consists of model statements 
and statements containing macro verbs used to define the macro and macro variables 
and determine which model statements are assembled. All macro statements that 
do not contain verbs are processed as model statements. A model statement results 
in an assembly language source statement. 


Macros may be defined in-line with the normal assembler source code, provided that 
the macro definition appears before that macro is called. Macro definitions are usually 
placed at the top of the assembler source file. This allows easy reference to the macro 
definitions since they are in one location. 


Macros may also be defined in external files. These files are simply text files (like the 
assembler source file) that contain macros defined in the same manner as those 
defined in the main assembler source file. Only one macro may be defined in a file. 
The assembler is informed of the existence of a macro library (i.e., a collection of 
macro files) by means of the MLIB directive (see Section 7.6.5). An example of the 
use of the MLIB directive is: 


MLIB .'E:|' 


The string enclosed in the quotes represents a directory name in the format required 
by the host operating system. 


To illustrate the use of a macro library, a library of macro definitions is assumed to 
be contained in a directory named ’E:’ and a file named ‘CPXADD’ that is a member 
of that directory. If the macro call 


LABEL CPXADD CX1,CX2 


is found in the assembler source, the in-memory macro table is first searched for the 
definition of CPXADD. CPXADD will be in the macro table if CPXADD was previously 
defined in the assembler source file or was previously encountered and read from a 
macro file. If the definition is not found in the macro table, a search of the normal 
assembler opcode/directive table is made. If found in the assembler opcode/directive 
table, the opcode is assembled as a normal machine instruction. If not, an attempt 
is made to find the file whose name is formed by appending the macro name to the 
MLIB name. If more than one MLIB directive has been encountered, the most recently 
defined library is searched first; then all remaining libraries are searched. If the file 
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is found, the macro definition is copied into the assembler’s macro file (in a 
compressed format), and an entry is made in the macro table for later use. 


Because of the sequential search for matching definitions (library search following 
the opcode/directive table search), a macro defined in a library will not automatically 
redefine a machine instruction, although this is easily done using an in-line macro 
definition. To extend this capability to the macro library, that library should include 
a text file named ‘MLIST’, which contains the names of the opcodes and currently 
defined macros (one name per line, starting with column one) which are to be 
redefined. 


A typical MLIST file may be constructed as follows, using the appropriate system text 


editor: 
file name <MLIB directory name>. MLIST 
record 1 ADD (opcode) 
record 2 LACK (opcode) 
record 3 DMOV (opcode) 
record 4 FSUB (macro) 


eof (MLIST) 


This MLIST file is read when the MLIB directive is processed. If a name found there 
matches a currently defined opcode or a name in the macro table, the matching entry 
is removed from its table. This forces a search of the libraries, since the name will 
not be found elsewhere. When a name is found matching an opcode, the message: 


' 82*e  ~ OPCODES.- REDEFINED’ 


is printed in the assembler listing, following the printing of the MLIB statement. A 
similar message: 


' **** MACROS REDEFINED' 


appears when currently defined macros are redefined. If this is intended, then no 
action is required; if not, then some action is necessary, such as the deletion of some 
or all of the records in the MLIST file. 


The name of a macro in file should be the same as the file name; otherwise, some 
inefficiency in macro usage will result. If the file named CPXADD contains a definition 
line such as: 


CPXMUL SMACRO MR, MD 


an entry for a macro named CPXMUL will be made in the internal macro table. The 
next call to CPXADD will be recognized as undefined and reentered into the internal 
macro table as CPXMUL. 


Note that the use of an MLIST file to override the assembler opcode table can result 
in unpredictable behavior of the assembler. Care should be taken in using this option. 
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8.1.1 Sample Macros 
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The following example defines a macro named INCX. SMACRO identifies the 
beginning of the macro definition, and $END identifies the end of the macro defi- 
nition. LACK 1, ADD X, and SACL X are model statements which will be placed into 
the source program upon a macro call. The macro INCX may be used in the source 
program as often as necessary. 


INCX SMACRO 
LACK 
ADD 
SACL 
SEND 


MMS 


The macro INCX may be called by simply placing the line INCX within the source 
file. The macro assembler will replace this line with the remainder of the definition, 
1.e.: 


LACK = 
ADD X 
SACL X 


X must be a symbol representing a memory address in the source program assigned 
by the EQU directive. INCX is limited because the macro can only be used with the 
single memory location X. The INC macro can be used with any memory location: 


INC SMACRO M 
LACK i; 
ADD 7M.S: 
SACL <M.S: 
SEND 


M is a macro parameter that is replaced by the actual parameter when the macro is 
called. M.S is the string component of this variable, i.e., the symbol representation 
of the variable. For example, the line INC Y will be replaced by: 


LACK 1 
ADD = 
SACL Y 


Likewise, INC Z will be replaced by: 


LACK 1 
ADD Z 
SACL Z 


Another component of a macro variable is the value component, as shown in the 
following example: 


ADDK SMACRO <X,NUM X and NUM are parameters. 
LACK :NUM.V: NUM V is the value component 
of parameter NUM. 
ADD eee 
SACL x. Ss 
SEND 


The macro call ADDK Y,3 will result in: 


LACK 3 
ADD Y 
SACL = 
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8.2 Labels 


A macro label consists of one to six characters. The first character must be alphabetic, 
optionally followed by alphanumeric characters. Macro labels are used to determine 
the sequence of processing of statements in a macro definition when the statements 
are not to be processed in order. 


Examples of valid macro labels: 


Ll 
NXTPNT 


C 


8.3 Strings 


Macro strings consist of one or more characters with enclosing quotes. Macro strings 
are defined in the same manner as the character string used in the assembly language 
source statement (see Section 7.4). 


Example of strings: 
‘ONE ' 


‘ ' (three blank spaces) 


8.4 Constants 


Constants for macros are defined in the same manner as constants in the assembly 
language source statements (see Section 7.3). 


Examples of constants: 


POE 3C 


$ (current location counter value) 


8.5 Variables 


Variables are symbols, used within a macro, which take on values through various 
mechanisms in the macro definition language. The maximum length of a variable is 
six characters. Macro variables are strictly local, i.e., they are available only to the 
macro that defines them. Macro $VAR (variable declaration verb) statements declare 
variables for a macro definition. 


The macro assembly language permits concatenation of macro variable components 
with strings, characters of model statements, and other macro variables. Variables 
are represented in the same manner as symbols in the Assembler Symbol Table (AST). 
This table maintains all the references to the variables, symbols, and labels used. 
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8.5.1 Parameters 


Parameters are macro variables that are declared in the $MACRO (macro definition 
verb) statement at the beginning of the macro definition. The sequence of parameters 
in the operand field of the $MACRO statement corresponds to the sequence of 
operands in the operand field of the macro call. In the expansion of a macro call, 
the parameters have values that are associated with the corresponding operands in 
the macro call. 


Examples of SMACRO statements with parameters: 
LABEL SMACRO A,B3 


NAME SMACRO O,RC,AMT 


8.5.2 Macro Symbol Table (MST) 
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The macro translator maintains a Macro Symbol Table (MST) similar to the Assembler 
Symbol Table (AST). Each entry consists of four components: string, value, length, 
and attributes of a variable or parameter. The macro assembler places parameters in 
the MST while processing a macro call. Variables are placed in the MST as the 
assembler processes the macro $VAR statements that declare variables. 


An entry’s string component in the MST contains a character string assigned to the 
macro variable or parameter by the macro expander. The value component contains 
the numerical equivalent of the string component if the string component is an 
integer. The value component can also contain the numerical value of the symbol 
if the string component is a symbol in the AST. 


If a parameter is an operand list, the value is the length of the list. The length 
component contains the number of characters in the string component. The attribute 
component of the MST is a bit vector, the bits of which correspond to the attributes 
of the variable or parameter. 


Macro definition example: 


ADDK SMACRO X,NUM The $MACRO directive defines the beginning of the defi- 
nition of the macro ADDK with parameters X and NUM. 


Macro call example: 
ADDK  VAR1,3 


With the MST now containing parameters X and NUM, the string component of 
parameter X is the character string VAR1. The attribute component indicates that the 
parameter is supplied in a macro call. The length component is four. The string 
component of parameter NUM is the ASCII character 3. The value component is three 
(expressed as a binary number) and the length component is one. The attribute 
component indicates that the parameter is supplied in the macro call. 


Each macro variable component may be accessed individually. Reference to a vari- 
able component is made in either binary mode or string mode. In the binary mode, 
the referenced macro-variable component is treated as a signed 16-bit integer. Binary 
mode access Is made by writing the variable name and component. When a reference 
is made to the string component of a macro variable in binary mode, the 16-bit integer 
value of the ASCII representation of the first two characters of the string is obtained. 
In the macro definition and call examples above, the binary-mode value of the string 
component of X is >5641, which is the ASCII representation for VA. 
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String-mode access of macro-variable components is signified by enclosing the 
variable in a pair of colons, e.g., :X:. Colons are always used in pairs to enclose a 
variable name. If a component qualifier is used, the pair of colons enclose the entire 
qualified name. 


8.5.3 Variable Qualifiers 


Parameter or variable components may be specified using the names shown in Table 
8-1. The variable name is followed by a period ’.’ and a single-letter qualifier. The 
following examples refer to previous macro examples using ADDK. 


Examples of qualified variables: 


a String component of variable VAR1. X.S equals the binary equivalent for 
VA or >5641. Astring mode indicated as :X.S: is equal to the string ‘VAR1’. 


X.A Attribute component of variable X. This component may be accessed by 
use of logical operators and attribute keywords (described in Table 8-3). 


x. V Value component of variable X. 


x5 Length component of variable X. In the first example of the macro call for 
the macro ADDK;:X.L: = 4. 


Table 8-1. Variable Qualifiers 


QUALIFIER] MEANING 


The string component of the variable 


The attribute component of the variable 
The value component of the variable 
The length component of the variable 


If a variable is not followed by a period '.’ and a single-letter qualifier, it is referred 
to as an unqualified variable. Except in an $ASG statement, an unqualified variable 
defaults to the string component of the variable. In the two following examples, the 
concatenated strings are equivalent: 


Example 1: :-CT.S:"WAY' Variable CT qualified 


Example 2: :-CT:'WAY’ Variable CT unqualified 
In model statements, binary references to macro variables MUST be qualified. 


All symbols in the Assembler Symbol Table (AST) have symbol components. (All 
components of macro parameters and the values of all AST symbols are directly 
accessible.) In order for other components to be accessed in a macro, the symbol 
must be assigned to the string component of a macro variable, using $ASG (value 
assignment verb). The additional qualifiers shown in Table 8-2 may be used with 
the macro variable to access the symbol components of the AST symbols. 
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Table 8-2. Variable Qualifiers for Symbol Components 


String component of a symbol that is 
the string component of a variable 


Value component of a symbol that is 
the string component of a variable 


Attribute component of a symbol that 
is the string component of a variable 


Length component of a symbol that is 
the string component of a variable 


Assuming that V1.S is defined as MASK and the statement MASK EQU >FF has 
been previously encountered in the assembly language source program, the following 
examples of qualified variables specify symbol components of string components of 
variables: 


V1.SS String component of the symbol MASK. Null unless a macro instruction 
has caused a string to be associated with it by using a $ASG statement. 


Vivcs¥ Value component of the symbol MASK, i.e., >FF. In string mode, 
'V1.SV: equals the characters ‘255’. 


V1.SA Attribute component of the symbol MASK. May be accessed by logical 
operators and keywords. 


V1.SL Length component of the symbol MASK. If a string has been assigned 
to MASK, then V1.SL is the length of that string. 


Concatenation is especially useful when a previously defined string is augmented 
with additional characters. The string ONE may be represented by a qualified variable 
such as CT.S. In that case, concatenation is expressed as: 


:CT os." WAY’ 
and provides the same result as writing: 
ONE WAY 


lf the qualified variable CT.S represented the string ‘TWO’, then the result of the 
concatenation in the example would be TWO WAY. Strings and qualified variables 
may be concatenated as required and the variable need not be first. Components 
of variables that are represented by a binary value (e.g., CT.V and CT.L) are converted 
to their ASCII decimal equivalents before concatenation. For example, 


teat”) WAL Se oa 
is expanded as 
ONE WAY 3 


since the length component of the variable CT is three. 
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8.6 Operators 


Three types of operators are available for use in the macro assembler: arithmetic, 
relational, and logical operators. 


8.6.1 Arithmetic Operators 


Arithmetic operators, using the functions of +, -, * (multiply), and / (divide), generate 
operand values. 


Example of an arithmetic operator: 


LABEL EQU $+4 (current location counter value + 4) 


8.6.2 Relational Operators 


Relational operators compare the values of two variables, or a variable and a constant, 
and return the answer of TRUE or FALSE. The relational operators are as follows: 


= Equal 

> Greater than 
< Less than 

# Not equal 


Examples of relational operators: 


SIF A.V>3 Process succeeding block if value component of variable 
A is >3. 
SIF B.L#A.L Process succeeding block if length component of variable 


B is not equal to length component of variable A. 


8.6.3 Logical Operators 


Logical (Boolean) operators perform the desired operation and return either TRUE 
or FALSE. The following are logical operators: 


& AND 
++ OR 
-- NOT 


Example of a logical operator: 


SIF (A.V>3)&(B.L#A.L) Process succeeding block if both expressions in 
parentheses are true. 
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8.7 Keywords 


The attribute component of assembler symbols and macro parameters contains 
information on various attributes of those symbols and parameters. The macro 
assembly language recognizes certain keywords that are used to access that infor- 
mation. A keyword is used with a logical operator and the attribute component to 
test or to set a specific attribute of a symbol or parameter. 


8.7.1 Symbol Attribute Component Keywords 


The keywords listed in Table 8-3 may be used with a logical operator and the symbol 
attribute component (.SA) to test or set the corresponding attribute component in 
the Assembler Symbol Table (AST). 


Table 8-3. Symbol Attribute Component Keywords 
KEYWORD SYMBOL MEANING 
Relocatable 
An operand of an REF directive 


An operand of a DEF directive 


Assigned a component string 


Defined as a macro name 


Not defined 


Note that the use of these attributes in conditional assembly (see SIF) can lead to 
pass conflict errors if the symbol has not been defined before the macro call. 


Examples using symbol attribute component keywords: 


V1.SA&SSTR The result of an AND operation between the attribute component 
of the symbol MASK (assuming V1.S has been defined as MASK) 
and a flag corresponding to keyword $STR. The expression is 
TRUE when the contents of the string component of MASK are 
not null; otherwise, the expression is FALSE. 


V1.SA++SREL The result of an OR operation between the attribute component 
of the symbol MASK and the flag corresponding to keyword $REL. 


8.7.2 Parameter Attribute Component Keywords 


The keywords listed in Table 8-4 may be used with a logical operator and the macro 
symbol attribute component to test or set the corresponding attribute in the MST 
attribute component or attributes of all variables in the MST. 


Assembler Macros 


Table 8-4. Parameter Attribute Component Keywords 


KEYWORD SYMBOL MEANING 


$PCALL Appears as a macro instruction operand. 


$SPOPL An operand list (the value component 
contains the number of operands in the 


list). 


A symbolic memory address (recog- 
nized when the variable is preceded by 
an @ character). 


Examples using parameter attribute component keywords: 


P6.A&SPCALL The result of an AND operation between the attribute component 
of variable P6 and the flag corresponding to keyword $PCALL. 
The expression is TRUE when variable P6 is a parameter supplied 
in a macro call; otherwise, the expression is FALSE. 


RA.A++SPSYM The result of an OR operation between the attribute component 
of variable RA and the flag corresponding to keyword $PSYM. 


8.8 Verb Statements 
The following verbs may be used in macro statements: 


SASG 
SELSE 
SEND 
SENDIF 
SIF 
SMACRO 
SVAR 


Any statement in a macro definition not containing a macro verb in the operation field 
is processed as a model statement. 


The macro verb statements are listed in alphabetical order and described in the 
following pages. The syntax and an example are also given. 


8.8.1 SASG (Value Assignment Verb) 


The $ASG statement assigns values to the components of a variable. Variables that 
are not parameters do not have values for any components until values are assigned 
using $ASG statements. Components of variables with previously assigned values 
may be assigned new values with $ASG statements. 


Syntax: SASG <expression/string> TO <var> [<comment> ] 


The expression operand may be any valid assembler expression and may contain 
binary-mode variable references and keywords. 
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A string may be one or more characters enclosed in single quotes or the concat- 
enation of such a literal string with the string mode value of a qualified variable. 
The <var> may be either an unqualified or a qualified variable. 


When the operands are both unqualified variables, all components are transferred to 
target variables. When the destination variable is qualified, only the specified 
component receives the corresponding component of the expression or string. An 
exception to this is when a string is assigned to the string component of a variable 
or symbol, the length component of that variable or symbol is set to the number of 
characters in the assigned string. If the attribute component of the destination 
variable is to be changed, only those attributes that can be tested using keywords 
are changed. Other attributes maintained by the macro assembler may or may not 
be changed as appropriate. A qualified variable that specifies the length component 
is illegal as a destination in a $ASG statement, and will NOT set the length compo- 
nent. 


The following examples illustrate the use of $ASG. Variables P3, V3, and CT are 
assumed to have been previously declared either as parameters in a S$MACRO state- 
ment or as variables in a $SVAR statement. 


SASG P3 TO V3 Assigns all the components of variable P3 to variable V3. 


SASG -TP3.5:‘°SBS" TO P3530 
Concatenates_ string ‘ES’ to the string component of vari- 
able P3, and set the string component to the result. This 
adds 2 to the length component of P3. 


SASG CT.A++SPSYM TO. CT.A 
Sets the flag in the attribute component of variable CT to 
indicate the symbolic address attribute. 


The $ASG statement may be used to modify symbol components as shown in the 
following examples. Assume that P3.V = 6 and P3.S = SUB. 


SASG 'TEN' TO G.S_ Assigns ‘TEN’ as the string component of variable G. When 
‘TEN’ is a symbol in the AST, this statement allows the use 
of symbol component qualifiers to modify the components 
of symbol TEN. 


SASG P3.V TO G.SV_ Sets the value component of the symbol in the string 
| component of variable G to the value component of variable 
P3. In this case, the value component of TEN is set to six. 


SASG -‘A’:P3.S:'S* TO.G.SS 
Concatenates string ‘A’, the string component of variable 
P3, and string ‘S’, and places the result in the string 
component of the symbol in the string component of vari- 
able G. Also sets the length component of the same symbol. 
Thus, the string component of TEN is ASUBS, and the 
length component is five. 


Keywords in a $ASG statement must be used with a Boolean (logical) operator and 
an attribute component of a variable in the source field. The attribute component 
must come first. When quoted strings are assigned to the string component of some 
variable, that string may later appear in the list of undefined symbols. 
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8.8.2 SELSE (Alternate Else Verb) 


The $ELSE statement begins an alternate block to be processed if the preceding SIF 
expression was false. 


Syntax: SELSE [<comment> ] 


Example: See SIF. 


8.8.3 SEND (Macro Definition Termination Verb) 


The SEND statement marks the end of the group of statements of the macro definition 
named in the operand. When executed, the $END statement terminates the proc- 
essing of the macro definition. 


Syntax: SEND [<MACRO NAME>] [<COMMENT> ] 


Example: SEND FIX Terminates the definition of the FIX macro. 


8.8.4 SENDIF (IF Termination Verb) 


The SENDIF statement terminates the conditional processing initiated by an SIF 
statement in a macro definition. 


Syntax: SENDIF [<comment> ] 


Example: See SIF. 


8.8.5 SIF (Conditional If Verb) 


The SIF statement provides conditional processing in a macro definition. The 
condition of the SIF statement determines whether or not a block of statements is 
processed, or which of two blocks of statements is processed. A block may consist 
of zero or more statements. 


An SIF statement is followed by a block of macro language statements terminated 
by an SELSE statement or an SENDIF statement. When the $ELSE statement is used, 
it is followed by another block of macro statements terminated by an SENDIF state- 
ment. When the expression in the SIF statement has a nonzero value (or is evaluated 
as TRUE), the block of statements following the SIF statement is processed. When 
the expression in the $IF statement has a zero value (or is evaluated as FALSE), the 
block of statements following the SIF statement is skipped. When the $ELSE state- 
ment is used and the expression in the SIF statement has a nonzero value, the block 
of statements following the $ELSE statement and terminated by the SENDIF statement 
is skipped. 


Syntax: SIF <expression> [<comment> ] 


The <expression> may be any expression as defined for the $ASG statement and 
may include qualified variables and keywords. The expression defines the condition 
for the SIF statement. 


Note that the expression is always evaluated in binary mode. Specifically, the rela- 
tional operations (<,>,=,#) operate only on the binary mode values of macro vari- 
ables. Logical operators may be nested. In addition, $IF blocks may be nested up to 
44 levels. 
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SIF 
ELSE 
SENDIF 


be 


SENDIF 


Ee 


Example: 


doa) Process the statements of BLOCK A when the value component 

BLOCK A of the symbol in the string component of variable KY contains 
a non-zero value. Process the statements of BLOCK B when the 
component contains zero. After processing either block of 

BLOCK B statements, continue processing at the statement following the 
SENDIF statement. 


(T.A &SPCALL) Process the statements of BLOCK A when the attribute 
component of parameter T indicates that parameter T is not 


BLOCK A supplied in the macro instruction. If parameter T is supplied, do 
not process the statements of BLOCK A. Continue processing 
at the statement following the SENDIF statements in either case. 

T.L=5 Process the statements of BLOCK A when the length component 
of variable T is equal to 5; otherwise, do not process the state- 

BLOCK A ments of BLOCK A. Continue processing at the statement 


following the SENDIF statement. 


8.8.6 SMACRO (Macro Definition Verb) 
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The S$MACRO statement must be the first statement of a macro definition. It assigns 
a name to the macro and declares the parameters for the macro. The macro name 
consists of one to six alphanumeric characters, the first of which must be alphabetic. 
Each <parm> is a parameter for the macro. The operand field may contain as many 
parameters as the size of the field allows and must contain all parameters used in the 
macro definition. The comment field may not be used if there are no parameters. 


Syntax: <macro name> SMACRO [<parm-list>] [<comment>] 


where <parm-list> is a sequence of parameters separated by commas. The macro 
definition is used in the expansion of macro calls where that macro name appears 
in the instruction field. 


Syntax for a call: 
<macro name> [<operand-list>] [<comment>] 


where <operand-list> is a sequence of operands, separated by commas. The macro 
name specifies the macro definition to be used. Each operand may be any expression 
or address type recognized by the assembler, or a character string enclosed in quotes. 
Alternatively, a list that is a group of operands enclosed in parentheses and separated 
by commas (when two or more operands are in the list) may be used. A list is 
processed as a set after removal of the outer parentheses during macro expansion. 


Operands (or lists) may be nested in parentheses in the macro call for use within 
macro definitions. For example, if the macro ONE is defined as 


ONE SMACRO P1,P2 
then the statement 
ONE PAR1,PAR2 


results in PAR1 being associated with P1, and PAR2 being associated with P2. 
Similarly, the statement 
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ONE PARI, (PAR21,PAR22) 


results in PAR1 being associated with P1, and PAR21,PAR22 being associated with 
PZ. 


The macro expander is responsible for replacing the macro call with the appropriate 
source code. Processing of each macro call in a source program causes the macro 
expander to associate the first parameter in the S$MACRO statement with the first 
operand or operand list on the macro call line and the second parameter with the 
second operand or operand list, etc. Each parameter receiving a value has the 
$PCALL attribute (see Table 8-4) set in the MST. When the macro definition has 
more parameters specified than the number of operands in the macro call, the SPCALL 
attribute is not set for the excess parameters. The $PCALL attribute also is not set 
if an operand is null (i.e., the call line has two commas adjacent or an operand list 
has zero operands). Expansion of the macro can be controlled by the number of 
operands by using the $PCALL attribute and SIF statements. 


For example, a macro definition containing 
AMAC SMACRO P1,P2,P3 

when called by 
AMAC  AB1,AB2 

sets $PCALL parameters P1 and P2, but not P3. Similarly, 
AMAC AY;7Aa13 

causes $PCALL to be set for P1 and P3, but not P2. 


When the macro call has more operands than the number of parameters in the 
SMACRO statement, the excess operands are combined with the operand or list 
corresponding to the last parameter to form a list (or a longer list). In the macro 
statements shown below, the operands of the two macro calls would be assigned 
to the parameters in the same way. 


Macro Call 1: 
ONE EQU 9 
TWO EQU 43 
THREE EQU 86 


FIX SMACRO P1,P2 MACRO FIX 


SEND 
FIX ONE, TWO, THREE MACRO CALL 
FIX ONE, (TWO, THREE) MACRO CALL 
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Macro Call 2: 


THIQOWNHAOONW YP 


> 
y.) 
= 


EQU 
EQU 
DATA 
DATA 
EQU 
EQU 
EQU 
EQU 
EQU 
SMACRO 


SEND 


PARM 


7 

15 

a 

63 

95 

47 

58 

101 

129 
P1,P2,;P3,P4,P5,;P6;P7,P8 ;P9 


A, ,B, GC} ,C,(D) 7E, (G6, (H,2)) 


For the above macro call, the parameter assignments for PARM are as follows: 


PILSS=A 

P1.A = $PCALL 
P1.L = 
P1.V=7 

P3.S = B 

P3.A = $SPCALL 
P3.L =1 

P3.V = 15 
P5.$=C 

P5.A = $PCALL 
P5.L = 1 

P5.V = 17 
P7S=€ 

P7.A = $PCALL 
P7.L = 1 

P7.V = 95 


P9.S = (no string) 
P9.A = (all false) 


P9.L=0 
P9.V =0 


P2.S = (no string) 
P2.A = (all false) 


P2.L=0 

P2.V =0 

P4.S = (no string) 
P4.A = $SPOPL 

P4.L =0 

P4.V=0 

P6.S =D 

P6.A = $SPCALL,$POPL 
P6.L = 1 

P6.V = 1 

P8.S = G,(H,l) 

P8.A = SPCALL,SPOPL 
P8.L=7 

P8.V =2 


A macro definition supercedes previous macro definitions and native instructions 
with the same name. Symbolic operands that appear in a macro call are treated as 
symbolic operands in native instructions; i.e., if they are not defined with the program 
in which they appear, they are listed as undefined symbols. 
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8.8.7 SVAR (Variable Declaration Verb) 


The $SVAR statement declares the variables for a macro definition. The $VAR state- 
ment is required only if the macro definition contains one or more variables other than 
parameters. More than one $VAR statement may be included, and each $VAR 
statement may declare more than one variable. Each <var> in the operand is a 
variable. 


Syntax: SVAR <var>[,<var>] [<comment>] 
Example: $SVAR A, Crs VS THREE VARIABLES FOR A MACRO 


The example declares variables A, CT, and V3, which must not have been declared 
as parameters. 


The $VAR statement does not assign values to any components of the variables; that 
is the function of the $ASG statement. $VAR statements may appear anywhere in 
the macro definition to which they apply, provided each variable is declared before 
the first statement that uses the variable. Placing $VAR statements immediately 
following the SMACRO statement is recommended for clarity in reading the source 
code. 


8.9 Model Statements 


A macro definition consists of model statements and statements that contain macro 
verbs. Processing a model statement results in an assembly language statement. 
This statement may be composed of the usual elements of an assembly language 
statement combined with string mode qualified variable components. 


Examples of model statements: 


IN *+,PA7,1 An assembly language source statement that contains a 
machine instruction. 


:P/7.S: LAR :P2.S8S:,R8 :V4.S: 

The string component of variable P7, followed by one blank, 
LAR, and one more blank, is concatenated to the string. The 
string component of variable P2 is concatenated to the 
result, to which R8 and three blanks are concatenated. A 
final concatenation places the string component of variable 
V4 in the model statement. The result is an assembly 
language machine instruction having the label and 
comment fields and part of the operand field supplied as 
string components. 


>MS.S:; The string component of variable MS. Preceding statements 
in the macro definition must place a valid assembly 
language source statement in the string component to 
prevent assembly errors. 


Note that conditional assembly directives may not appear as operations in a model 
statement. Comments supplied in model statements may not contain periods since 
the macro assembler scans them. Improper use of punctuation may cause syntax 
errors. 
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8.10 Macro Examples 


8.10.1 


Macros may simply substitute a machine instruction for a macro instruction, or they 
may include conditional processing, access the Assembler Symbol Table (AST), and 
employ recursion. Several examples of macro definitions are described in the 
following paragraphs. 


ID (Identification Macro) 


The ID macro, an example of a macro with a default value, supplies two DATA 
directives to the source program. The ID macro consists of nine other macro state- 
ments, four of which are model statements. The definition is as follows: 


ID SMACRO 


DATA 


SIF 


DATA 


SELSE 


DATA 


START EQU 


SENDIF 


SEND 


Syntax: [<label>] 


WS,PC 


sWS.S: 


PC.A&SPCALL 


SPC 8355 


START,15 


Defines 1D with parameters WS and PC. 


Model statement: places a DATA directive with 
the string of the first parameter as the operand 
in the source program. 


Tests for presence of parameter PC. 


Model statement: places a DATA directive in 
the source program. The first operand is the 
string of the second parameter, and the second 
operand is 15. This statement is processed if 
the second parameter is present. 


Starts the alternate portion of the definition. 


Model statement: places a DATA directive in 
the source program. The first operand is label 
START, and the second operand is 15. This 
statement is processed if the second parameter 
is omitted. 


Model statement: places label START in the 
source program. This statement is processed 
if the second parameter is omitted. 


Ends the conditional processing. 


Ends the macro. 


ID <exp>[,<exp>] [<comment>] 


The addresses may be expressions or symbols. 


Example of a macro call for macro ID: 


ID 


The resulting source code would be 


DATA 
DATA 


WORK1,BEGIN 


WORK1 
BEGIN,15 
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If only one operand is supplied, the macro instruction could be coded as follows: 
ID WORK2 


This would result in the following source code: 


DATA WORK2 
DATA START. 15 
START EQU $ 


This form of the macro instruction imposes two restrictions on the source program. 
The source program may only call the 1D macro with a single parameter once. This 
is necessary to prevent the use of the label ‘START’ more than once. Problems with 
labels supplied in macros may be prevented by reserving certain characters for use 
in macro-generated labels. A macro definition may maintain a count of the number 
of times it is called, and use this count in each label generated by the macro. 


8.10.2 GENCMT (Generate Comment Macro) 


The GENCMT macro implements only those comments that appear in the macro 
definition and the expansion of the macro. In the following example, the first five lines 
define the macro, followed by :V.S: that expands the macro definition. 


Example of assembler list file: 


0001 IDT 'GENCMT ' 
0002 GENCMT SMACRO 
0003 SVAR V 
0004 * THIS IS A MACRO DEFINITION COMMENT. 
0005 SASG "-*",.T0 V.S 
0006 :V.S: THIS IS A MACRO EXPANSION COMMENT. 
0007 SEND 
0008 
0009 " 
0010 GENCMT 
OOO1 * THIS IS A MACRO EXPANSION COMMENT. 
OO11 OQO000 OOO0O0 DATA 0,1 
OO00O1 OOO1 
0012 GENCMT 
0001 * THIS IS A MACRO EXPANSION COMMENT. 
0013 GENCMT 
0001 * THIS IS A MACRO EXPANSION COMMENT. 
0014 0002 0004 DATA 4 
0015 END 


NO ERRORS, NO WARNINGS 
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8.10.3 FACT (Factorial Macro) 


The FACT macro, an example of the recursive use of macros, produces the assembly 
code necessary to calculate the factorial of N where N is an immediate value, and 
store that value at data memory address LOC. FACT accomplishes this by calling 
FACT1, which calls itself recursively. 


Example: 
FACT SMACRO N,LOC * N IS AN INTEGER CONSTANT AND 
* * LOC IS THE DATA MEMORY ADDRESS 
* * WHERE N! IS TO BE STORED. 
* 
SIF N.V<2 
ve 5 ia * thes) 20. mR 
SACL :LOC: 
SELSE 
LACK :N.V: * WW >= 2 SO, STORE. .N AT LOC, 
SACL :LOC: * DECREMENT N, AND DO THE 


SASG N.V-1 TO N.V  * FACTORIAL OF N-1. 
FACT. <N.Vi»t bo? 


SENDIF 
SEND 
x 
FACT1 SMACRO M,AREA 
SIF M.V>1 
LT > AREA: * MULTIPLY PRESENT FACTORIAL 
aPYS. 33M. V3 * BY PRESENT POSITION. 
PAC 
SACL :AREA: * SAVE RESULT. 


+ 


DECREMENT POSITION. 
RECURSIVE CALL. 


SASG M.V-1 TO M.V 
FACT1 :M.V:,:AREA: 
SENDIF 

SEND 


+ 


8.11 Macro Error Messages 


Table 8-5 lists and defines the macro error messages, and gives correction informa- 
tion. 


Table 8-5. Macro Error Messages 


ee ee DESCRIPTION 


MACRO LINE TOO LONG In a macro definition, macro directive lines may be only 58 characters long. 
Model statements, when fully expanded, may be only 60 characters long. 


LONG MACRO VARIABLE QUALIFIER Macro variable qualifiers may be only one or two characters long. 


TOO MANY MACRO VARIABLES The total number of macro parameter variables and labels in a single macro 
definition may not exceed 128. 


INVALID MACRO QUALIFIER The only valid macro qualifiers are: S, V, L, A, SS, SV, SL, and SA. 


VARIABLE ALREADY DEFINED A macro variable cannot be redefined within a macro. 
IF LEVEL EXCEEDED The maximum nesting level of SIF directives is 44. 


MACRO ASSEMBLER PROGRAM ERROR | The macro assembler has detected an internal error. These can be caused 
by incorrect syntax. 
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9. Link Editor 


The Link Editor combines separately generated object modules with associated 
procedures and overlays to form a single, linked, relocatable object module that can 
be installed and executed on various computer systems. The object code is generated 
by an assembler supplied with the TMS320C25 software development system. The 
link editor is currently available for the VAX (VMS) and TI/IBM PC (MS/PC-DOS) 
operating systems. 


This section describes the Link Editor, its files and control commands, and gives 
examples of various linking procedures. Included in this section are the following 
major topics: 


& Description (Section 9.1 on 9-2) 


i Program definition (Section 9.2 on 9-2) 
Phase and task 


e Link Editor Files (Section 9.3 on 9-2) 
Link control file 
Object modules 
Libraries 
Linked output file 
Listing file 


6 Linker Commands (Section 9.4 on 9-5) 
Entering a command 
Command set summary (listed according to function) 
Individual command descriptions (alphabetized) 


@ Linking Examples (Section 9.5 on 9-36) 
Simple link 
RAM/ROM partitioning 
Partial link 
Library creation 


# Link Editor Error Messages (Section 9.6 on 9-49) 
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9.1 Description 


The Link Editor provides symbol resolution for external references and definitions 
created by the REF and DEF assembler directives (see Section 6). Without this 
function, all modules would have to be compiled or assembled at once, and modules 
written in different languages could not be mixed. 


The Link Editor builds a list of symbols from the REF tags in the object modules that 
are included in the linking process. The Link Editor then resolves references by 
matching DEF tag symbols with the REF tags and inserting the correct values for 
these symbols in the linked object code. 


The Link Editor can position the three defined segments (program, data, and 
common) to prescribed boundaries for eventual ROM/RAM partitioning. Program, 
data and common segments are defined by the PSEG, DSEG, and CSEG assembler 
directives, respectively. If these directives are not used, the entire object module is 
tagged as a program segment. 


When PSEG, DSEG, and CSEG tags are encountered in the included modules, the 
Link Editor reorganizes segments from each module into three segments in the linked 
output. The first segment contains the PSEGs of all included modules, the second 
segment contains the DSEGs, and the third segment the CSEGs of all included 
modules. The beginning location for each segment can be user-defined. 


The Link Editor also allows overlays and procedure/task segmentation. However, if 
the system being used loads only one module at a time, procedure/task segmentation 
and overlays cannot be used because they produce multiple output modules. 


9.2 Program Definition 


To use the Link Editor, each program must be defined as a phase or a task. Below 
are the definitions of each. 


Phase The smallest functional unit that can be loaded as a logical entity during 
execution in an overlay structure. 


Each phase is identified by a name and a level number. The root phase 
is at level O and is that portion of the program that must remain memory 
resident. Other phases (level 1 and above) that do not have to be 
simultaneously memory-resident can overlay each other. 


Task A complete program containing both variable data and executable code 
or the variable data portion of a program (for procedure/task segmen- 
tation). 


9.3 Link Editor Files 
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Executing the Link Editor utility begins by accessing the Linker and then responding 
to prompts for the link control file, linked output file, and listing file. The Link Editor 
utility uses the following five files in the linking process: 


Link control file 
Object modules 
Libraries 

Linked output file 
Listing file. 
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Each file is given a pathname so that when that pathname is entered, the Link Editor 
can search for that file. The pathnames for the link control file, object modules, 
declared libraries, the linked output file, and the listing file are in the listing file. An 
example of pathname structure (default value) for the link control file is given for the 
two operating systems currently available for the TMS320C25 Link Editor. 


Pathname System 
[PROJECT.MACK]SEGMENT.CON VAX (VMS) 
A:PARTIAL.CTL TI/IBM PC (MS/PC-DOS) 


Each of the link editor files is described in the succeeding subsections. 


9.3.1 Link Control File 


The link control file is an input file that controls the operation of the Link Editor. 
This file contains a set of link control commands called a control stream which 
defines the modules to be linked and how they are to be linked. The Link Editor links 
the object modules in the order specified by the linker commands. See Table 9-2 
for a summary of all the linker commands. 


The link control file must be created ahead of time. Entering a pathname instructs the 
editor to look for a file containing the necessary control commands. 


9.3.2 Object Modules 


Object modules are the input programs that are to be linked together. They are 
contained in files and must consist of either ASCII or compressed 990-tagged object 
code. The ASCII 990-tagged object code is the type of code generated by the 
assembler supplied with the TMS320C25 Software Development System. The object 
code consists of ASCII tags followed by data fields (see Section 7.9 for a description 
of object code format). 


As the Link Editor finishes writing out an object module, it names the module and 
gives the number of object records it contains. When the link terminates normally, 
the last line written reads '*** LINKING COMPLETED'. The date and time at the 
end of the link are printed on the last line. The date and time captured at the 
beginning of the link are printed at the top of every page and on the last card of every 
module in the linked object. 


Object modules can be explicitly user-defined with the INCLUDE command in the 
control file, or automatically included by the Link Editor as a result of a search for 
unresolved references. 
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9.3.3 Libraries 


Libraries are directories or files containing collections of object modules. An object 
library may be either random or sequential. A random library is a directory of object 
modules in separate files, whereas a sequential library is a file containing one or more 
object modules concatenated together. See Section 8.5.4 for examples of library 
creation. 


Libraries are used to automatically resolve the REF and DEF tag symbols between 
object modules specified in INCLUDE commands. 


Two types of symbol resolution are implemented: 


@ Automatic symbol resolution by default (the AUTO command) when the END 
command is detected in the control file unless the NOAUTO command has been 
used. 


@ Symbol resolution at a user-defined point in the linking process when a 
SEARCH or FIND command is used. The SEARCH command is used with 
random libraries and the FIND command with sequential libraries. 


Libraries defined by the LIBRARY command are searched in the same order they are 
defined. Any additional unresolved references created by modules to satisfy refer- 
ences are also resolved automatically. Automatic symbol resolution still occurs at 
the end of the linking process for any remaining unresolved references unless a 
NOAUTO command is in the control file. 


9.3.4 Linked Output File 


The linked output file is an 80-character output file containing the 990-tagged object 
format load module in the "LINKED OUTPUT” file. This load module appears in 
ASCII or compressed format, depending on the use of the FORMAT command in the 
object link control file. The response to the linked output file name specifies the 
destination of the load module. 


9.3.5 Listing File 
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The listing file consists of a listing that includes the control stream and a link map 
that lists the modules with their origins and lengths. The link map consists of the 
following four sections: 


1) Individual constituent object modules 

2) Common segments 

3) Symbols (external) 

4) Unresolved references (identified even if the NOMAP option has been selected). 


The response to the listing file access name specifies the destination of the listing 
generated during the link edit. The pathnames for the control file, the listing file, the 
linked object file, and declared libraries are in the listing file. Messages are listed for 
detected errors in the listing file. 


The Link Editor creates two temporary files on the work file disk. Therefore, sufficient 
space for two disk or diskette files must be available. 
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9.4 Linker Commands 


Link control commands define the modules to be linked and how they are linked. 
This section gives some rules for entering a command in the link control file. 


A command set summary of all the linker commands, arranged according to function, 
is provided for easy reference. Each command in the summary table is next described 
individually. Linker syntax and example(s) are also given for each command. The 
commands are listed in alphabetical order. 


9.4.1 Entering a Command 
When entering a command in the control file, these rules should be followed: 


@ Either the entire command or only the first four characters may be specified. 

@ At least one space must separate the command from its parameters. 

@ Comments may be entered either on a separate line or following the command 
parameters. 

@ All comments must be preceded by a semicolon (;). 

@ The command must be contained within the first 72 characters of the line. 


9.4.2 Linker Command Set 


Table 9-1 lists the symbols used in the syntax definitions of the linker commands. 


Table 9-1. Linker Syntax Symbols 


PSMNBOL Po MCANING 


< > User-defined parameters. 
= Optional parameters. They may be omitted. 
{ } Alternative parameters, one of which must be entered. 
a The preceding parameter may be repeated. 
rts Indicates “contents of”. 
<acnm> | An access name for a file or library must be entered for 
the parameter. 
<base> The starting location of a segment, expressed as either 
a decimal or hexadecimal number up to five digits in 
length. 
<level> The level of a phase. 
<name> | The name of a specified area. Consists of one to eight 
alphanumeric characters, the first of which must be 
alphabetic. 
(<name>) | The name of a member in a library. 
<value> | The number of lines, between 16 and 60, to be printed 
on a page. Replaces the default value of 60. 
> Represents hexadecimal, as does also a leading zero. 


Words shown in capital letters and special characters 
not listed here must be entered as shown. 


The link command set summary of Table 9-2 is arranged according to function and 
alphabetized within each functional grouping. Of the four groups, the first group 
consists of basic commands that are required to perform basic Link Editor functions. 
The second group consists of ROM/RAM partitioning commands. The third group 
includes those miscellaneous commands that perform auxiliary link editor functions, 
such as specifying default conditions and procedure/task segmentation. The fourth 
group consists of the partial link commands. 


Link Editor 
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Table 9-2. Linker Command Set Summary 


BASIC COMMANDS 


Command 
Indicates the end of the control stream. This is a required command. 


FIND Specifies a search of only sequential libraries for unresolved references at this point 
in the control stream. 


Defines the format of the linked output module as ASCII or COMPRESSED code. 
The default is ASCII object code. 

Defines one or more modules to be included in the linking process. At least one 
INCLUDE command is required in each control stream. 

LIBRARY Defines a random library directory. 

PHASE Defines the level and name of a phase in a program. Either the PHASE or the TASK 


command must appear in each control stream. Multiple phases are allowed when 
overlays are used. 


Specifies a search of defined random libraries for unresolved references at this point 
in the control stream. 


Defines a phase to be installed and executed as a task or standalone program. A 
name is assigned the task. 


ROM/RAM PARTITIONING COMMANDS 


FORMAT 


INCLUDE 


SEARCH 


TASK 


Command 


ALLOCATE Controls the relative positioning of the program, data, and common segments 
(PSEG, DSEG, and CSEG assembler directives, respectively). 


COMMON Specifies the starting location of the common segment in the linked output. 
DATA Specifies the starting location of the data segment in the linked output. 


PROGRAM Specifies the starting location of the program segment in the linked output. 


AUXILIARY FUNCTION COMMANDS 


Ee Sr See Senin At 2 Si dea die ey 
ADJUST Aligns a phase or a module within a phase on a specified boundary. 


AUTO Specifies automatic symbol resolution at the end of the control stream (default 
condition). 


DUMMY Suppresses generation of the linked output file. Useful for error identification or 
when only a listing file is required. 


ENTRY Specifies a symbol for an entry tag to be produced. 

NOAUTO Inhibits automatic symbol resolution, allowing the user to explicitly control library 
searching for unresolved references. 

NOMAP Suppresses the output of the link map listing by omitting the module, common, and 
symbol maps from the listing. 

NOPAGE Inhibits page ejects between the link maps of each phase. 


NOSYMT Omits symbol! tables from included modules in the linked output file (default 
condition). 


PAGE Causes page ejects between link maps for each phase (default condition). 


PROCEDURE Defines a phase of the link edit structure which can be installed as a procedure. 
Used for procedure/task segmentation only. An alternate version of this command 
can be used to support levels 1 and 2. 


REPLACE Replaces one external symbol name for another in the next object file read in. 
SYMT Includes symbol tables in linked output files. 


PARTIAL LINK COMMANDS 
bb OS ie aii Gad oats i) ees 

ALLGLOBAL Declares all external definitions in included modules as global symbols for subse- 
quent relinking (default condition). 

GLOBAL Identifies the symbols defined in included modules to be processed as global 
symbols for subsequent relinking. 

NOTGLOBAL Declares either specified externally defined symbols or all externally defined symbols 
in included modules as local symbols. 


PARTIAL Performs a partial link and outputs either ASCII or compressed object code. The 
output of a partial link must be linked again without the PARTIAL command before 
the program can be loaded and executed. 


Link Editor 


9.4.3 Individual Command Descriptions 


Each command in the linker command set summary is described in the following 
pages. Information, such as linker syntax, a description, and example(s), is given for 
each command. The commands are listed in alphabetical order. 
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ADJU Specify Alignment of Phase Command ADJU 


Syntax 


Description 
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ADJUST [<n>] 


where <n> = a decimal number less than 16 specifying a power-of- 
two bytes. A value greater than 15 causes an error. 
When the parameter is omitted or equal to zero, align- 
ment is on the next word boundary. 


The ADJUST command specifies the alignment of a phase or of a module within 
a phase on a specified boundary. 


When the ADJUST command appears immediately before a PHASE command, 
the next phase and all subsequent phases of the same level and with the same 
parent node are aligned on the specified boundary, relative to the beginning of 
the program. 


If the ADJUST command follows a PHASE command but precedes all INCLUDE 
commands in the phase, the effect is the same as above. When the ADJUST 
command follows a PHASE command but precedes an INCLUDE command, the 
next module in that phase is aligned on the specified boundary, relative to the 
beginning of the phase. 


ALLG Declare Global Symbols Command ALLG 


Syntax ALLGLOBAL 


Description The ALLGLOBAL (partial linking) command declares all external definitions in 
included modules as global symbols. ALLGLOBAL is a default condition. 


Global symbols are externally defined in the linked output module and therefore 
may be re-linked in a subsequent linking process. 
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ALLO Allocate Relative Positioning of Segments Command ALLO 


Syntax ALLOCATE 


Description The ALLOCATE command controls the relative positioning of program, data, and 
common segments (PSEG, DSEG, and CSEG directives, respectively). ALLO- 
CATE has no parameters. 


ALLOCATE directs the Link Editor to reserve space for all outstanding data and 
common segments as if no more object modules were to be included in the link. 
The primary purpose of the ALLOCATE command is to aid the user in sharing 
non-reentrant procedures between different tasks. 


The ALLOCATE command only works if all read/write data is contained in data 
segments (DSEGs) or common segments (CSEGs). 


AUTO Automatic Symbol Resolution Command AUTO 


Syntax AUTO 


Description The AUTO command specifies automatic symbol resolution using defined libraries 
at the end of the linking process. The AUTO command has no parameters and 
is optional. It is the default condition. 


COMM Set Starting Location Counter for CSEG Command COMM 


Syntax 


Description 


Example 1 


Example 2 


Example 3 


Example 4 


COMMON {<base>[,<name>] [,<name>]...} 


where <base> = the starting location of the common segment. It can 
be expressed as either a decimal or hexadecimal number 
up to five digits in length. 


<name> = the name of the common segment. Any unnamed 
common segment begins after the last data area 
encountered. The commons are allocated in the order 
in which the definitions appear in the object module. 


The COMMON command defines the starting address for the specified common 
segment (CSEG). Commons that are loaded at the specified address must be 
specifically identified within this command. The COMMON command is only valid 
when used with the PROGRAM command and is ignored if used alone. 


More than one COMMON command may be used, and a continuation can be 
performed by repeating the command using a previously named common instead 
of a starting address. The COMMON command cannot be used in partial links. 


COMMON 01000,COMA Begin common COMA at location 
>1000. 
COMM >1000,COMA Results are the same as the 


preceding example. 


COMMON COMA , COMB Begin common COMB immediately 
following COMA. 


COMM 4096 ,COMA,COMB Results are the same as the 
two preceding examples. 


DATA Set Starting Location Counter for DSEG Command DATA 


Syntax DATA <base> 
where <base> = the starting location of the data segment. It can be 
expressed as either a decimal or hexadecimal number 
up to five digits in length. 
Description The DATA command defines the absolute starting address for the data segment 


(DSEG) in the linked output. The DATA command is only valid when used with 
the PROGRAM command and is ignored if used alone. 


The DATA command may appear more than once in the control stream, but the 
first DATA command must appear before the first INCLUDE command. If the 
DATA command is omitted, the starting location for each data area defaults to the 
end of the corresponding program area. 


The DATA command cannot be used in partial links. 
Example 1 DATA 01000 Begin data segment at location >1000. 


Example 2 DATA 4096 Same as the preceding example. 


DUMM Suppress Generation of Linked Output File Command DUMM 


Syntax DUMMY 


The DUMMY command supresses generation of the linked output file. This 
command is useful for error identification or when only a listing file is needed. 


DUMMY has no parameters. 


Description 


END Specify End of Control Stream Command END 


Syntax END 


Description The END command specifies the end of the control stream. The command is 
required in every control stream. 


ENTR Specify a Symbol for an Entry Tag Command ENTR 


Syntax ENTRY <symbol> 
Description The ENTRY command specifies a symbol for the entry point in order to produce 
an entry tag. This overrides all entry tags received in input object modules. 
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FIND 


Syntax 


Description 


Example 


Search Sequential Libraries 
for Unresolved References Command FIND 


FIND <acnm>[,<acnm>][,<acnm>]... 


where <acnm> = the access name of the sequential library that is to be 
searched for unresolved references. 


The FIND command specifies a search of sequential libraries for members 
representing unresolved references. Only one pass is made through a library in 
response to a single FIND command. The search occurs at the point in the linking 
process where the FIND command occurs. 


The FIND command functions as a SEARCH command but applies to sequential 
libraries only. The FIND command is listed as a SEARCH command in the link 
map. 


FIND A:* .EXT For PC/MS-DOS system. 


9-17 


FORM Define Format of Linked Output Module Command FORM 


Syntax 


Description 


FORMAT {ASCII,COMPRESSED} 
The FORMAT command defines the format of the linked output module. 


The format specified may be either ASCII or COMPRESSED object code. In ASCII 
format, each integer value in the object is represented as a four-byte character 
string. ASCII format is also called 990-tagged object format and is the default 
condition. Compressed format is more efficient to use since each integer value 
is represented as a two-byte word. 


GLOB Identify Global Symbols Command GLOB 


Syntax 


Description 


GLOBAL [symbolIname][,symbolIname]... 


where symbolname =~ a symbol that is to be processed as a global symbol. It 
is defined at assembly time and consists of six charac- 
ters or less, the first of which must be alphabetic. 


The GLOBAL command is a partial linking command, identifying the symbols 
defined in included modules to be processed as global symbols. Global symbols 
are externally defined in the output module that may be relinked. 


Each parameter specifies a symbol that is to be processed as a global symbol. 
The command may include several parameters and may appear more than once 
in the command stream. If no parameters are specified, the command functions 
as an ALLGLOBAL command. 


Symbols defined by the GLOBAL command are not affected by the NOTGLOBAL 
command (no parameters) that declares all symbols to be local. 


INCL Specify Modules To Be Included in Link Command INCL 


Syntax INCLUDE {<acnm>[,<acnm>]...,(<name>)[,(<name>)]...} 


where <acnm> = the access name of a file containing the object 
module(s) to be included in the linking process. 


(<name>) = a member in a library. 


Description The INCLUDE command specifies modules to be included in the linking process. 
This command is required in the control stream. More than one INCLUDE 
command may be used as needed. 


A PROCEDURE, TASK, or PHASE command must precede the first INCLUDE 
command. 


If the <name> parameter is used, enclose only the file name or module name of 
the object modules (rather than the entire access name) in parentheses. The 
specified <name> must be of a file contained in a defined random library. The 
Link Editor searches the defined libraries for the specified module. 


lf no parameters are given, in-line text format (not compressed) object code is 
assumed. The in-line object (see Example 3) is delimited by either end-of-file 
or by a record with ’/*’ in columns one and two. This method is suitable, for 
example, when the control file is read in from a card reader (in which case, 
end-of-file is denoted by a ‘/*’ card). 


Example 1 INCLUDE (X) Search defined random libraries for 
a file named X and include the 
module(s) in that file. 


Example 2 INCLUDE TEST.MPO Include the module TEST.MPO from the 
default directory on a PC/MS-DOS 
system. 

Example 3 

INCLUDE 


KOO6CCARTMOND50020LBL2B150021LBL2B240000LBL2C240000LBL2D2A00207F1E7F 
BCE26BCE26BFE80EQOOOQO000BFE80E00010000BCE1BB0201B0388B4802B48A97F1E1F 
BFFEEBCE27BCE50BCEO4BCEO5BCE01B567BB568CBCEOOBCEOFBCE1FB807AB81A87F048F 
: CARTMOND 4/20/35 ~-10253:14 ASM3S2ZO02Z0 PC 1.0 65.092 

/* 
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LIBR Define Random Library Directories Command LIBR 


Syntax LIBRARY <acnm>[,<acnm>]... 
where <acnm> = the access name of the directory that is to be defined 
as a library. : 
Description The LIBRARY command defines random library directories. Random libraries 


must consist of a directory, and the files in the directory must contain 990-tagged 
object modules. Sequential libraries, consisting of a sequential file of object 
modules, are indicated using the FIND command. 


Example LIBR A:*. EXT Define drive A: as a random 
library of files with extension 
-EXT on a PC/MS-DOS system. 
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NOAU Inhibit Automatic Symbol Resolution Command NOAU 


Syntax 


Description 
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NOAUTO 


The NOAUTO command inhibits automatic symbol resolution at the end of the 
linking process. This command allows the user to explicitly control library 
searching for unresolved references through use of the SEARCH and FIND 
commands. NOAUTO has no parameters. 


Omit Module, Common, and Symbol Maps 


NOMA from Listing Command NOMA 


Syntax NOMAP 


Description The NOMAP command specifies that the module, common, and symbol maps 
are to be omitted from the listing. This gives some improvement in terms of speed 
and number of symbols that can be processed. The following information is still 


printed on the listing file: 


3S Length of task and procedure(s) 
# Unresolved references 
% Release number of the Link Editor. 


NOMAP must appear before any PHASE or TASK commands are used. 
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NOPA Set No Page Ejects Between Link Maps Command NOPA 


Syntax NOPAGE 


Description The NOPAGE command sets no page ejects between the link maps for each phase. 
New pages are started for the listing of the first phase and when the number of 
lines per page has been exceeded. 


9-24 


NOSY Omit Symbol Table from Modules Command NOSY 


Syntax NOSYMT 


Description The NOSYMT command omits symbol tables from included modules in the linked 
Output file. This provides for more compact object code but does not allow 
symbolic debugging. 


The NOSYMT command may appear anywhere in the control file. However, if 
an overlay structure is used, the NOSYMT command must appear in the root phase 
(phase 0). 


NOSYMT is the default option and is the inverse of SYMT. 
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NOTG Define Local Symbols Command NOTG 


Syntax NOTGLOBAL [symbolname][,symbolname]... 


where symbolname =~ a symbol which is to be processed as a local symbol. 
It is defined at assembly time and consists of six char- 
acters or less, the first of which must be alphabetic. 


Description The NOTGLOBAL command is a partial linking command, declaring that either 
specified externally defined symbols or all externally defined symbols in the 
included modules are to be processed as local (not global) symbols. 


Local symbols are not externally defined in the partially linked output module and 
thus can only be referenced by modules included in the current partial link. 


The command may include several parameters and may appear more than once 
in the command stream. If no parameters are specified, all symbols are processed 
as local, except those specified in the GLOBAL command. 
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PAGE et Page Eject to Separate Link Ma mmand PAGE 


Syntax PAGE [value] 
where value = the number of lines to be printed on a page, replacing 
the default value of 60. The value parameter is optional, 
but when present, the value must be between 16 and 
60. 
Description The PAGE command causes page ejects to separate the beginning of each link 


map for each phase. This is the default condition. 
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PART 


Syntax 


Description 
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Perform Partial Link Command PART 


PARTIAL 


The PARTIAL command performs a partial link and outputs either ASCII or 
compressed object code. The output of a partial link is not executable and must 
be linked again without the PARTIAL directive before the program can be loaded 
and executed. 


The PARTIAL command causes the Link Editor to do the following: 


1) Resolve all external references defined by any module included in the partial 
link. 


2) Retain all entry points in the partial link as an entry in the output (subject 
to GLOBAL, NOTGLOBAL, ALLGLOBAL commands). 


3) Retain the common tags and update common numbers. 
4) Output one data section that is the total of all input data sections. 


Partial linking is allowed for single phases only, and the control stream must 
contain either a TASK or PHASE 0 command. lf partial linking of overlays is 
required, each phase must be partially linked separately as a phase 0. The phase 
level and name may be redefined in subsequent links. The following commands 
are invalid with partial links: ALLOCATE, PROGRAM, DATA, COMMON, and 
DUMMY. 


PHAS 


Syntax 


Description 


Example 1 


Example 2 


Define Phase Level and Name Command PHAS 


PHASE <level>,<name> 


where <level> = the level of the phase. Levels specified greater than zero 
can be used for overlay structures only. Level 0 defines 
the root (memory-resident) phase. Each subsequent 
PHASE command defines the level and name of an 
overlay. 


<name> = the name of the phase. It consists of one to eight 
alphanumeric characters, the first of which must be 
alphabetic. The name supplied becomes the IDT name, 
placed on the last card of the object module produced 
and on the identification fields of ASClIl-formatted 
object records. 


The PHASE command defines the level and name of a phase in a program. 


PHASE 0 and TASK commands are logically identical; one and only one of these 
two commands must appear in each control stream. 


The Link Editor produces an output module for each phase of the program. PHASE 
commands are followed by INCLUDE commands that define the modules included 
in the phase. Multiple phases are allowed when overlays are used. 

PHASE O,MAIN Define phase MAIN at level 0O. 


PHAS Ey DpiLek Define phase DISK at level 2. 
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PROC 


Syntax 


Description 


Example 1 
Example 2 


Example 3 


9-30 


Define Phase as Procedure Command PROC 


PROCEDURE {<name>,<level,name> } 


where <name> = the identifier of the procedure to be used. The parameter 
consists of one to eight alphanumeric characters, the 
first of which must be alphabetic. 


<level> = the level of the phase. 


The PROCEDURE command provides procedure/task segmentation by defining 
a phase of the link edit structure, which can be installed as a procedure (a 
re-entrant procedure may be shared among several tasks). The name supplied 
becomes the IDT name, placed on the last record of the object module produced 
and on the identification field of ASClIl-formatted object records. This command 
is useful in ROM/RAM partitioning for generating load modules with a level of 
root phase 0. 


When used, the PROCEDURE command must precede the TASK command, all 
PHASE commands, and the INCLUDE command that defines the procedure 
module. 


The PROCEDURE command is used with the INCLUDE commmand to define the 
procedure. The PROCEDURE command defines the name of the procedure, and 
the INCLUDE command defines the modules that are to be in that procedure. 
Procedures contain the program segment (PSEG), which may be the entire 
program but is usually only the executable code and read-only data. 


A generalization of the standard PROCEDURE command is supported for levels 
1 and 2. In place of a single first procedure, any number of other level-one 
procedures can be defined, any of which can be resident in memory at a given 
time under the user’s control. The length of the first procedure area is the maxi- 
mum of the lengths of the individual level-one modules. Analogous properties 
apply to second-level PROCEDURES. Modules brought in by automatic call to 
satisfy references in any procedure module are placed in the root. 


PROCEDURE FORLIB Define procedure FORLIB. 
PROC RUNLIB Define procedure RUNLIB. 
PROCEDURE 2,FILEMG Define a procedure FILMG at level 2. 


PROG Define Absolute Starting Counter for PSEG Command PROG 


Syntax PROGRAM <base> 
where <base> = the starting location of the program segment. It can 
be expressed as a decimal or hexadecimal number up 
to five digits in length. 
Description The PROGRAM command defines the absolute starting address for the program 


segment (PSEG) in the linked output. 


The PROGRAM command may be used more than once. The first PROGRAM 
command must appear before the first INCLUDE command. Use of the PROGRAM 
command by itself or with the DATA and COMMON commands causes the linked 
output to be loaded at the specified address (base). 


Example 1 PROGRAM O1FO00 Begin program segment at location 
>1FOO. 

Example 2 PROG >1F00 Same as the preceding example. 

Example 3 PROG 7936 Begin program segment at location 


7936 (>1F00). 
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REPL Replace Oldsym with Newsym Command REPL 


Syntax REPLACE <oldsym(newsym) >[,<oldsym(newsym) >]... 


where oldsym = the currently existing external symbol representing a 
reference, definition, or common name. 


(newsym) = the new external symbol to replace the oldsym. 


Description The REPLACE command specifies that in the next file read in, each occurrence 
of ‘oldsym’ as an external symbol is replaced by ‘newsym’. The command applies 
to every module in a file containing multiple modules. It applies only to the first 
file in an INCLUDE command list. If the command immediately precedes a FIND, 
SEARCH, or END command, it still applies to the next single file read in. 


lf ‘oldsym’ is $DATA and an affected module contains a DSEG, the link editor 
converts the DSEG to a common with the name ‘newsym’. This means that no 
data segment is identified in the listing, and if other instances of the common name 
occur, the common may be extended in length or promoted (moved up to a 
lower-numbered phase). 


Note that data segments can be shared by using the REPLACE command to 
convert them to a common. Appropriately used, this permits a module to share a 
data segment in an ancestor phase and places no restrictions on the order of 
definition of segments with different lengths. 
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SEAR Search for Unresolved References Command EAR 


Syntax SEARCH [<acnm>][,<acnm>]... 


where <acnm> = the access name of random libraries to be searched. 
The order of these access names determines the order 
of the search. If no <acnm>s are specified, the libraries 
defined by the LIBRARY commands define the search 
ordering. 


Description The SEARCH command directs the Link Editor to search for unresolved references 
at any point in the control stream. 


If a SEARCH command is given in a phase other than the TASK or PHASE 0 phase, 
searching is performed only for symbols that are unresolved in that phase. Unre- 
solved references that were established in or promoted to other phases are ignored. 


A SEARCH command in a TASK phase causes searching to be done for every 
phase (for the given phase and all its descendant and previous phases). The only 
way the SEARCH command can be applied to more than one phase is by re-en- 
tering a phase defined earlier. This is permitted only for the task phase and for the 
purpose of doing SEARCHes and FINDs. 


Example 1 SEARCH Search defined libraries for 
unresolved references. 


Example 2 SEARCH A:*.EXE Search drive A: as a library of 
files with extension .EXE ona 
PC/MS-DOS system. 
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SYMT Include Symbol Tables in Linked Output File Command SYMT 


Syntax SYMT 


Description The SYMT command causes the Link Editor to include symbol tables in the linked 
output file when the linker input files contain such symbols. These symbols were 
provided in the assembler as a result of selecting the SYMLST option (see the 
OPTION directive in Section 7.7). Although symbol tables make the linked 
module larger, they are useful for symbolic debugging. 


SYMT is the inverse of the NOSYMT option. 
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TASK 


Syntax 


Description 


Example 1 


Example 2 


Define Phase as Task Command TASK 


TASK [<name>] 


where <name> = the identifier of the task module. The <name> can have 
up to eight characters. The name supplied becomes the 
IDT name, placed on the last record of the object 
module produced and on the ID fields of ASCII-for- 
matted records. If the parameter is omitted, the IDT 
name of the first included module is used as the task 
name. 


The TASK command defines a phase that can be installed and executed as a task 
or standalone program, and assigns a name to the task. 


A task is either a complete program, containing both variable data and executable 
code, or it is the variable data portion of a program (procedure/task segmenta- 
tion). The TASK and PHASE 0 commands are logically identical; one and only 
one of these two commands must appear in each control stream. 


When task/procedure segmentation is used, the TASK command must follow all 
PROCEDURE commands and precede all PHASE and INCLUDE commands that 
define the task module. The TASK command can be given after overlays have been 
defined (to re-enter the root phase). 


TASK FORPRG Define task named FORPRG. 


TASK Define task and assign it the IDT name 
of the first included module. 
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9.5 Linking Examples 


Examples showing how and when to use the link control commands are provided 
in this section. Among the examples are a simple link (Section 8.5.1), ROM/RAM 
partitioning (Section 8.5.2), and a partial link (Section 8.5.3). In addition, examples 
are given for creating random and sequential libraries (Section 8.5.4). 


Three separately assembled modules, MAIN, RESET, and INTRPT, are to be linked 
together. Figure 9-1, Figure 9-2, and Figure 9-3 contain the assembly language 
source for each module. The TMS320C25 Assembler produces 990-tagged object 
code that the Link Editor requires as input. 


The first and third linking examples assume that each module is contained in a 
separate file named MAIN.MPO, RESET.MPO, and INTRPT.MPO, respectively, and 
that the three files are listed on a diskette in a TI/IBM PC (MS/PC-DOS) operating 
system. The second example is similar, but bases its file access on the VAX/VMS 
Operating system. 


IDT 'MAIN' 
* 
DEF MAIN 
REF RESET, INTRPT 
* DATA PAGE 6 RAM DEFINITION 
NEXTO EQU 0 
SAMPLE EQU 32 
* 
PSEG 
BEGIN B RESET 
INTO B INTRPT 
* 
BSS 28 
MAIN LARP AR1 
LDPK 6 
LOOP IDLF 
LALK INPUT 
TBLR SAMPLE 
LRLK AR1,>0300+SAMPLE 
CNFP 
MPYK 0 
ZAC 
RPTK 31 
MACD >FFOO, *- 
APAC 
SACL * 
CNFD 
LALK OUTPUT 
TBLW NEXTO 
B LOOP 
PEND 
* 
CSEG ‘IO! 
INPUT BSS 1 
OUTPUT BSS 1 
CEND 
* 
END 


Figure 9-1. Source for Module MAIN 
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RESET 


CFIR 


"RESET ' 


RESET 
MAIN 


AR1 
AR1,>0300 


a2 
e+ 
AR1,>0200 


176,=203 ,297,7398,493,-566,598,=-567 
448 ,£2212,-116; 172, 71684,3193;78;,7 
6,.975193,~-1684,772;°176, =212,448 
“1675596, —-566 ,493,-398, 297; ~203,176 


Figure 9-2. Source for Module RESET 
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* 


STATUS 


TEMP1 
TEMP 2 


* 


INTRPT 


* 


INPUT 


OUTPUT 


* 


LASTIN 


LASTO 


* 


IDT 'INTRPT! 

DEF INTRPT 
* DATA PAGE O RAM DEFINITION 

EQU 96 

EQU 97 

EQU 98 

PSEG 

SST STATUS 

LDPK 0 

IN TEMP1,PAO 

LALK LASTIN 

TBLR TEMP 2 

TBLW TEMP 1 

LAC TEMP 2 

SUB TEMP 1 

SACL TEMP 1 

LALK INPUT 

TBLW TEMP 1 

LALK OUTPUT 

TBLR TEMP 1 

LALK LASTO 

TBLR TEMP 2 

LAC TEMP 2 

ADD TEMP 1 

SACL TEMP 1 

OUT TEMP1,PA1 

LALK LASTO 

TBLW TEMP 1 

LST STATUS 

RET 

PEND 

CSEG 'TO! 

BSS 1 

BSS 1 

CEND 

DSEG 

BSS - 

BSS 1 

DEND 

END 


Figure 9-3. Source for Module INTRPT 
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9.5.1 Simple Linking 


Every control stream must contain either a TASK or PHASE 0 command to define the 
name of the program being linked. In addition, the control stream must contain one 
or more INCLUDE commands to define modules that are being linked. The control 
stream is terminated with an END command. The following is an example control 
stream on the TI/IBM PC MS/PC-DOS operating system for linking the three 
example object modules generated for MAIN, RESET, and INTRPT. 


PHASE O,SIMPLE 
INCLUDE MAIN.MPO 
INCLUDE RESET.MPO 
INCLUDE INTRPT .MPO 
END 


The three modules may be specified in one INCLUDE command rather than with three 
separate commands. The diskette containing the modules (A: ) may also be defined 
as a library. When this is done, only the file name (enclosed in parentheses) need 
be specified. The Link Editor searches the defined library for the required files. An 
example of a control stream using the INCLUDE command is as follows: 


PHASE QO,SIMPLE 

LIBRARY A:*.MPO 

INCLUDE (MAIN) , (RESET) , (INTRPT) 
END 


Since MAIN references RESET and INTRPT, and the directory containing these 
modules has been defined as a library, MAIN is the only module that must be spec- 
ified in the INCLUDE command, as shown in the following example: 


PHASE 0,SIMPLE 
LIBR A:*.MPO 
INCL (MAIN) 
END 


At the end of the control stream, the Link Editor automatically searches the defined 
library for unresolved references and includes the modules that satisfy the references 
in the linking process. 


The Link Editor produces a listing of the linking process and writes it to a specified 
file. Figure 9-4 is an example of the listing file produced. The listing file for this 
example consists of three pages. The first page contains a copy of the link control 
stream. The second page lists the parameters used when the Link Editor was 
initialized (access names of the control file, linked output file, and listing file) and 
the format of the linked output. Since the FORMAT command was not included in 
the control stream, the default, ASCII, is used. 


The third page contains the link map, which is generated to facilitate debugging. 
The link map lists the origins and lengths of the phase being linked, the modules 
included in the link, and any common segments. The origins are relative to the 
beginning of the phase. The order in which the included modules are linked is 
indicated by the number listed next to the module name. The link map also lists the 
symbols defined in the included modules, indicating the module in which the symbol 
is defined (number) and the resolved location of the symbol (value). An asterisk 
(*) preceding the symbol name indicates that the symbol is not referenced in the 
included modules. An asterisk to the right means the symbolic value is absolute. 
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PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:49:35 PAGE 1 
COMMAND LIST 


PHASE O,SIMPLE 
INCLUDE A:MAIN.MPO 
INCLUDE A:RESET.MPO 
INCLUDE A:INTRPT.MPO 
END 


PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:49:35 PAGE 2 
LINK MAP 


CONTROL FILE = A:SIMPLE.CTL 

LINKED OUTPUT FILE = A:SIMPLE.LOD 

LIST FILE = A:SIMPLE.MAP 

OUTPUT FORMAT = ASCII 

PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:49:35 PAGE 3 
PHASE O . SIMPLE MODULE ORIGIN = 0000 LENGTH = 0083 


MODULE NO ORIGIN LENGTH TYPE DATE TIME CREATOR 
MAIN 1 0000 0036 INCLUDE 06/21/85 08:48:34 ASM320 
RESET 2 0036 002D INCLUDE 06/21/85 08:49:03 ASM320 
INFEPT:.. 3 0063 OO01C INCLUDE 06/21/85 08:49:18 ASM320 
SDATA 3 OO7F 0002 

COMMON NO ORIGIN LENGTH 

IO 1 0081 0002 


Pe FS iN Le? sees 


NAME VALUE NO NAME VALUE NO NAME VALUE NO 
INTRPT 0063 2 MAIN 0020 P| RESET 0036 2 
LENGTH OF REGION FOR TASK = 0083 
NUMBER OF RECORDS FOR MODULE SIMPLE = 10 
TOTAL RECORDS WRITTEN = 10 
***k*k LINKING COMPLETED 06/21/85 08:49:42 


Figure 9-4. Listing File for a Simple Link 


Link Editor 


9.5.2 ROM/RAM Partitioning 


Each example module has a program segment defined by the PSEG assembler 
directive, a data segment defined by the DSEG directive, and a common defined by 
the CSEG directive. Program segments generally contain instructions and nonvari- 
able data (read only). Data segments generally contain variable data (read/write) 
and are labeled by the Link Editor as $SDATA. Common segments contain variable 
data that may be shared by more than one module. 


The Link Editor automatically reorganizes the output so that all the program segments 
of the included modules are together, followed by the data segments and then the 
common segments. The link control commands PROGRAM, DATA, and COMMON 
can be used to specify the beginning location of each output segment. These 
commands cannot be used with a PROCEDURE command or a PHASE command 
with a level greater than zero. 


The following is an example of the control stream for a VAX/VMS operating system, 
which is used to partition the program and data segments into potential ROM and 
RAM locations. 


PHASE 0, SEGMENT 

PROGRAM >0000 

DATA >2000 

COMMON >3000,10 

INCLUDE [PROJECT .MACK]MAIN.MPO 
INCLUDE [PROJECT .MACK] RESET.MPO 
INCLUDE [PROJECT.MACK] INTRPT.MPO 
END 


The example assumes that location >0000 is in ROM and locations >2000 and 
>3000 are in RAM. This control stream causes the program segment of MAIN to 
begin at location >0O000, followed by the program segment of RESET, and then 
INTRPT. The data segment begins at location >2000. The common segment that 
is to be shared by the modules begins at location >3000. Note that if the common 
segment is not specifically named in the COMMON command, the segment begins 
immediately following the last data segment. 


Figure 9-5 contains the listing produced by this link. Use of the PROGRAM, DATA, 
and COMMON commands causes the phase length to be listed as zero and the origins 
to be listed as absolute locations. An asterisk(*) preceding the symbol name indicates 
that the symbol is not referenced in the included modules. An asterisk following the 
value of a symbol name indicates an absolute location. Linking absolute code 
generated by the assembler (AORG assembler directive) also causes the phase length 
to be listed as zero and the origins to be absolute locations. 
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VAX/32020 LINKER VERSION v.2.3 85.084 6/21/85 08:49:53 PAGE 1 
COMMAND LIST 


PHASE QO, SEGMENT 
PROGRAM >0000 
DATA >2000 


COMMON >3000 

INCLUDE [PROJECT .MACK]MAIN.MPO 
INCLUDE [PROJECT .MACK] RESET .MPO 
INCLUDE [PROJECT .MACK] INTRPT.MPO 
END 


VAX/32020 LINKER VERSION v.2.3 85.084 6/21/85 08:49:53 PAGE 2 
LINK MAP 


CONTROL FILE = [PROJECT.MACK] SEGMENT. CTL 
LINKED OUTPUT FILE = [PROJECT.MACK] SEGMENT.LOD 
LIST FILE = [PROJECT.MACK] SEGMENT.MAP 


OUTPUT FORMAT = ASCII 
VAX/32020 LINKER VERSION v.2.3 85.084 6/21/85 08:49:53 PAGE 3 
PHASE 0O SEGMENT MODULE ORIGIN = 0000 LENGTH = 0000 


MODULE NO ORIGIN LENGTH TYPE DATE TIME CREATOR 
MAIN 1 0000 0036 INCLUDE 06/21/85 08:48:34 ASM320 
RESET a 0036 002D INCLUDE 06/21/85 08:49:03 ASM320 
INTRPT . 3 0063 OO1C INCLUDE 06/21/85 08:49:18 ASM320 
SDATA 3 2000 0002 

COMMON NO ORIGIN LENGTH 

IO : 3000* 0002 


DEF PEN fT TO NS 


NAME VALUE NO NAME VALUE NO NAME VALUE NO 
INTRPT. ..,,0063%-:—3 MAIN 0020*.,...1 RESET O036* 2 
LENGTH OF REGION FOR TASK = 0000 

NUMBER OF RECORDS FOR MODULE SEGMENT = 10 

TOTAL RECORDS WRITTEN = 10 

**x* LINKING COMPLETED 06/21/85 08:50:05 


Figure 9-5. Listing File for ROM/RAM Partitioning 
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9.5.3 Partial Linking 


This section shows how to generate a partial link and then include the output of the 
partial link in a subsequent link. Only ASCII object code can be used in partial linking 
on the TMS320C25 device. 


The PARTIAL command is used in the control stream to specify a partial link. In this 
example, modules RESET and INTRPT are to be linked together in a partial link. The 
output of the partial link is not executable and must be linked again without the 
PARTIAL command so that the output of this partial link will then be linked with 
module MAIN to produce an executable module. The following is the control stream 
for the partial link, using the TI/IBM PC (MS/PC-DOS) operating system: 


PARTIAL 

PHASE QO,PARTIAL 
INCLUDE A:RESET.MPO 
INCLUDE A: INTRPT.MPO 
END 


All commands pertaining to partial links must be issued before any INCLUDE, 
SEARCH, and FIND commands. The PARTIAL command must’be given before the 
first INCLUDE command in the control stream. In a partial link, only one phase is 
allowed and must be defined by the PHASE 0 or TASK command. 


The ALLGLOBAL, GLOBAL, and NOTGLOBAL commands are used with the 
PARTIAL command to define the scope of DEF tags in modules included in the partial 
link. These symbols are specified as either global or local. All externally-defined 
symbols are processed as global symbols. Global symbols are externally defined in 
the partially linked output modules and may be referenced in a subsequent link. Local 
symbols are not externally defined in the partially linked output module; therefore, 
they may be referenced in the current partial link. Since none of these commands 
are included in the control stream, the default, ALLGLOBAL, is used. 


The output of the partial link can now be linked with module MAIN to produce an 
executable module, using the following control stream: 


PHASE O, PROJ 
INCLUDE B:MAIN.MPO 
INCLUDE B:PARTIAL.MPO 
END 


The listing and object modules from a partial link using the PARTIAL command are 
given in Figure 9-6. 


The second part of the link, in which the output of the partial link is relinked without 
using the PARTIAL command, is performed next. The listing and object files for 
relinking the output of the partial link are shown in Figure 9-7. 
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PC/CrossWare Family Linker v.2.3 85. 
COMMAND LIST 


PARTIAL 

PHASE O,PARTIAL 
INCLUDE A:RESET.MPO 
INCLUDE A:INTRPT.MPO 
END 


PC/CrossWare Family Linker v.2.3 85. 
LINK MAP 


CONTROL FILE A: PARTIAL. CTL 


LINKED OUTPUT FILE A:PARTIAL.MPO 


LIST FILE A: PARTIAL.MAP 


OUTPUT FORMAT ASCII 


PC/CrossWare Family Linker v.2.3 85. 


084 6/21/85 08:51:09 PAGE 1 


084 6/21/85 08:51:09 PAGE 2 


084 6/21/85 08:51:09 PAGE 3 


PHASE 0 PARTIAL MODULE ORIGIN = 0000 #£LENGTH = O004D 
MODULE NO ORIGIN LENGTH TYPE DATE TIME CREATOR 
RESET i: 0000 002D INCLUDE 06/21/85 08:49:03 ASM320 
INTRPT 2 002D 001C INCLUDE 06/21/85 08:49:18 ASM320 
SDATA 2 0000 0002 
COMMON NO ORIGIN LENGTH 
IO 2 0000 0002 
DBs ION FT Taroom s 
NAME VALUE NO - £NAME VALUE NO 
*INTRPT O02D 2 *RESET 0000 1 
UNRESOLVED REFERENCES 
MAIN : 
LENGTH OF REGION FOR TASK = 004D 
NUMBER OF UNRESOLVED REFERENCES = 1 
NUMBER OF RECORDS FOR MODULE PARTIAL = 9 
TOTAL RECORDS WRITTEN = 9 
**k** LINKING COMPLETED 06/21/85 08:51:17 


a. Listing File for a Partial Link 


Figure 9-6. Listing and Object 


Files for a Partial Link 
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KOO49PARTIAL MOOO2SDATA OOOOMOOO02IO O0O0250000RESET S5SOO2DINTRPT7FOEAF 
40000MAIN AOOO00B5589BD100B0 300BCAOOBCB2 3B60A0BD100B0200BCB1FBFCAO07F136F 
COOODBFF80EQQ0Q00000BOOBOBFF35B0129BFE72B01EDBFDCABO256BFDC9BO1CO7F140F 
BFF2CBFF50B0304BF96CBOC7 9BO008B000 7BO006BO005B0C7 9BF96CBO 304BFF507F12EF 
BFF2CBO1COBFDC9BO0256BFDCABO1EDBFE72B0129BFF35BOOBOA002DB7860BC8007FOC4F 
B8061BD001T0000B5862B5961B2062B1061B6061BD001NO0000002B5961BD0017F225F 
NOQ0010002B5861BD001T0001B5862B2062B0061B6061BE161BD001T0001B59617F219F 
B5060BCE267FD8AF 
PARTIAL 06721/85 08:51:09 XLNKPC v2.3 85.084 


b. Object File for a Partial Link 


Figure 9-6. Listing and Object Files for a Partial Link (Concluded) 


The second part of the link, in which the output of the partial link is relinked without 
using the PARTIAL command, is performed next. The listing and object files for 
relinking the output of the partial link are shown in Figure 9-7. 
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PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:51:33 PAGE 1 
COMMAND LIST 


PHASE 0,PROJ 
INCLUDE A:MAIN.MPO 
INCLUDE A:PARTIAL.MPO 
END 


PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:51:33 PAGE 2 
LINK MAP 


CONTROL FILE = A:PROJ.CTL 

LINKED OUTPUT FILE = A:PROJ.LOD 

LIST FILE = A:PROJ.MAP 

OUTPUT FORMAT = ASCII 

PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:51:33 PAGE 3 
PHASE 0 PROJ MODULE ORIGIN = OOOO LENGTH = 0083 

MODULE NO ORIGIN LENGTH TYPE DATE TIME CREATOR 
MAIN cf 0000 0036 INCLUDE 06/21/85 08:48:34 ASM320 
PARTIAL 2 0036 0049 INCLUDE 06/21/85 08:51:09 XLNKPC 
SDATA 2 OO7F 0002 

COMMON NO ORIGIN LENGTH 


IO E 0081 0002 


ie oe 2 Redd OONES 


NAME VALUE NO NAME VALUE NO NAME VALUE NO 
INTRPT 0063 2 °&MAIN 0020: - 1 -RESET 0036 2 
LENGTH OF REGION FOR TASK = 0083 

NUMBER OF RECORDS FOR MODULE PROJ eee 

TOTAL RECORDS WRITTEN 7 ge ES 

**** LINKING COMPLETED 06/21/85 08:51:40 


a. Listing File for Relinking the Partial Link Output 


KOO83PROJ AOQOOBFF80CO036BFF80C006 3A0020B5589BC806BCEI1FBDO0017F1D8F 
CO0081B5820BD100B0320BCEO5BAOOOBCAOOBCBI1FB5C90BFFOOBCE15B6080BCE047F129F 
BDOO1CO082B5900BFF80C0022A0036B5589BD100B0 300BCAOD0OBCB2 3B60A0BD1007F193F 
BO2Z00BCB1FBFCAOCO04 3BFF80COO020BOOBOBFF35B0129BFE72BO1EDBFDCAB02567FOEDF 
BFDC9OBO1LCOBFF2CBFF50B0304BF96CBO0C7 9BOO08B0007BOO006BO005B0C7 9BF96C7F10CF 
BO304BFF50BFF2CBO1COBFDC9BO0256BFDCABO1EDBFE72B0129BFF35BOOBOA00637F0C9F 
B7860BC800B8061BD001C007FB5862B5961B2062B1061B6061BD001C0081B59617F1C0OF 
BD001C0082B5861BD001C0080B5862B2062B0061B6061BE161BD001C0080B59617F1DAF 
B5060BCE267FD8AF 
PROJ 06/21/85. “O8sni333 XLNKPC v2.3 85.084 


b. Object File for Relinking the Partial Link Output 


Figure 9-7. Listing and Object Files for Relinking the Partial Link Output 
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9.5.4 Library Creation 
The linker can accommodate two object library types: random and sequential. 


A random library can be created almost automatically. Whenever one or more object 
files are placed in the same directory or sub-directory, that directory becomes a 
random library. Some examples of random libraries are as follows: 


DUAO:[USERO7.PROJ2710.PARTS] 
(VAX), where the example indicates a directory containing 
object file members named (eg., PART1.OBJ, 
INITIAL.OBJ, CLEANUP.OBA, etc.). 


A:*.MPO (MS-DOS), where the name indicates a drive and all files 
with the extension .MPO (e.g., QUICK.MPO, BTREE.MPO, 
SHELL.MPO, etc.). 


The creation of sequential libraries is more involved. Since sequential libraries offer 
no advantages over random libraries, their use is probably restricted to those users 
of systems not supporting random libraries, i.e., not supporting multilevel directories 
or “wild-card” file specifications. 


A sequential library is a single file and consists of a “dictionary,” followed by one 
or more concatenated object modules. The user must order the elements in a 
sequential library so that no object segment contains an external reference to a 
preceding segment. The concatenated object files may be created by assembling a 
source file created by concatenating the source files of several proposed members 
of the sequential library. Such a source file may appear as shown in Figure 9-8. 


IDT 'TRESRT' 
TITL ‘THIS IS THE FIRST LIB MEMBER' 
DEF TRESRT , QUICK 

* 


QUICK EQU $ 


TRESRT EQU. $ 


END 
* 
IDT ‘ELEM! 
TITL ‘STILL IN SEQ LIB' 
DEF ELEM 
END 
* 
IDT  'LASTPROG' 


TITL ‘ET CETERA' 


END 


Figure 9-8. Source File for Sequential Library Creation 
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The assembler output contains all modules within the same file, yet distinct. The use 
of a text editor allows the creation of such a file by appending the object files that 
result from independent assembly of the proposed library members. The dictionary 
structure must be created by use of the text editor. It precedes the first object module 
and must match the following pattern: 


First line, the library ‘IDT’ record: OllllaaaaaaaaF 


where 0 = tag 
Ill] = length of the dictionary 
aaaaaaaa = library name 
F = end-of-record tag 
user-defined information out to 80th character 


Example: OOOOOSEQLIBO1F 04/10/85 08:15:00 


One entry for each object module included in the library: 
Fillllaaaaaaaa; 


where F = tag 
| = IDT marker 
Ill = length of PSEG of module 
aaaaaaaa = IDT of the module 
’ = record end marker 


Example: FIOOCEFASTSORT; 


For each DEF within a module: FEtllllaaaaaa{,tlIllaaaaaa}; 


where F = tag 
= tag 
= type of DEF ("A” = absolute, “R” = relative) 
lll = value of the DEF’d symbol 
aaaaaa = 6-character name of symbol DEF’d in this module 
_ = if more (up to five DEFs allowed per record 
; = if no more 


Example: FEAOO50PACK ,ROOACUNPAK ,AOEO8ENCODE; 


For each REF within the module: FR aaaaaad, aaaaaa} 


where F = tag 
R = tag 
: ‘ = five blanks 

aaaaaa = 6-character name of symbol REF’d 

if more (up to five REFs allowed per record) 

if no more 


f 


Example: FR EXREF , ESYM, X 


For each COMMON segment contained within the module: 
FCilllaaaaaa{,IIllaaaaaa}; 


where F = tag 
C = tag 
lll = length of COMMON segment 
aaaaaa = 6-character COMMON segment name 
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Example: FCO140COMNAM,0266SBLANK; 


For each DATA segment defined within the module: 


FDIIII {1 } 
where F = tag 
D = tag 
lll = length of DATA segment 


‘= six blanks 
up to five DSEGs allowed, separated by commas 
terminated by ; 


Example: FD0010 ,0032 


This set of records is repeated for each object module in the library. The final record, 
just prior to the first record of the first library member, must contain a colon in the 
first character position. The remainder of this colon record is not specified. It can 
be used for date, time, and other user-defined information. 


9.6 Link Editor Error Messages 


Messages are listed for detected errors in the listing file. The Link Editor error 
messages are named and described below. 


When the error-message description indicates that a malfunction of the link editor 
has occurred, please contact the Texas Instruments Customer Response Center 
(CRC) hotline number, 1-800-232-3200, extension 2171, for assistance. 


‘(’ EXPECTED: The REPLACE command expects a parenthesis. 


ADDRESS SPACE HAS OVERFLOWED IN THIS MODULE: The maximum 
address required to represent this module is >10000 or greater. No valid object 
module can be produced for this phase. The linker continues to produce the map, 
but with increased likelihood that it will abort from internal errors. 


ADDRESS SPACE TRUNCATED FOR TAG = X IN THE SEGMENT START- 
ING AT YYYY: The 320-specific tags have a seven-bit address field that has 
overflowed. 


ALIGNMENT VALUE MUST BE IN THE RANGE 0..15: The value in the 
ADJUST command is out of range. 


AN ACTIVE BUFFER SHOULD HAVE BEEN CLOSED: A buffer that needs to 
be closed is still marked as active. 


ATTEMPT MADE TO WRITE TO A NIL SEGMENT: The linker attempted to 
write to a nonexistent segment. Indicates a malfunction of the link editor; call hotline 
immediately. 


ATTEMPT MADE TO WRITE TO INACTIVE SEGMENT: The linker has 
attempted to write to an unopen segment. Indicates a malfunction of the link editor; 
call hotline immediately. 


ATTEMPT TO ACTIVATE AN ALREADY ACTIVE SEGMENT: The linker has 
attempted to open a segment that is already active. Indicates a malfunction of the 
link editor; call hotline immediately. 
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ATTEMPT TO ACTIVATE NIL SEGMENT: The linker has attempted to open a 
nonexistent segment. Indicates a malfunction of the link editor; call hotline imme- 
diately. 


ATTEMPT TO ALLOCATE AFTER DSEG OF CSEG DEFINED: The ALLOCATE 
command has been given after data and/or common segments have been encount- 
ered. 


ATTEMPT TO MOVE NON-COMMON SEGMENT: An attempt has been made 
to move a segment that is not a common. Indicates a malfunction of the link editor; 
call hotline immediately. 


ATTEMPT TO ORDER A NIL SEGMENT: A common that was never defined 
cannot be placed in the stream of commons. Indicates a malfunction of the link 
editor; call hotline immediately. 


ATTEMPT TO REDEFINE COMMON ORIGIN: Directives to place a common 
Origin provide information that conflicts with information that has been already 
determined. 


BAD CHAIN FOR XXXX TO YYYY: Ina partial link, the reference chain for XXXX 
points to the address YYYY that is outside the scope of the segment. 


BAD INDEX - COMMAND FORMAT NOT RECOGNIZED: In a partial link, 
an error was detected in the control record such that the current index is negative. 


BAD TAG IN CHAIN FOR XXXX AT YYYY: In a partial link, an invalid tag was 
encountered in the processing of the reference chain. If this error occurs, the object 
module has been damaged. 


CANNOT ORDER COMMONS FROM DIFFERENT MODULES: Commons 
that are overlayed in procedures of the same phase level cannot be ordered together. 
This usually occurs in a partial link. 


CAN’T ASSIGN LUNO TO LIBRARY: The limit has been exceeded in the number 
of files that can be opened at one time. 


CAN’T OPEN FILE: A file that should be opened cannot be opened. The system 
return code is identified in the immediate preceding warning. 


CAN’T OPEN LIBRARY: Ap error code was returned or an attempt made to open 
the directory. 


CHAIN TO UNINITIALIZED LOCATION FOR XXXX AT YYYY: The reference 
chain for value XXXX points from YYYY to an insignificant address. Processing of 
the chain is discontinued. | 


COMMAND NOT VALID WITH PARTIAL LINK: The specified command is not 
valid in producing a partial link. 


COMMAND ONLY VALID WITH PARTIAL LINK: The GLOBAL, NOTGLOBAL, 
and ALLGLOBAL commands must follow a PARTIAL command in a control stream. 


COMMON HAS NOT BEEN PLACED VALIDLY: An attempt has been made 
to place a common at two or more locations. 


COMMON NAME TRUNCATED: The common name has been truncated to six 
characters. This is a trivial warning and processing proceeds with the truncated name. 


COMMON NUMBER INVALID: The common number given an M tag is not in 
the valid range. —~ 
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COMMON ORIGIN HAS ALREADY BEEN SET: An attempt has been made to 
define a common origin already set with a previous COMMON command. 


COMMON ORIGIN INVALID: The origin for a common is not valid. 


COMMON ORIGIN WAS NOT DEFINED: The first common name specified in 
a COMMON command was never defined in the link. 


COMMON SEGMENT HAS NO SYMBOL DEFINED: Asymbol has been given 
for a common segment, but the segment itself does not exist. 


COMMON SYMBOL IS NOT VALID: The given common symbol is not legal. 


COMMON SYMBOL WAS NEVER DEFINED: A common segment was not 
found corresponding to the common symbol. 


COMPRESSED FORMAT NOT SUPPORTED FOR 320 INPUT MODULES: 
The linker only recognizes ASClIl-formatted input modules for these object codes. 


CONFLICTING COMMON SYMBOL FOUND: A common symbol that is not 
consistent with previous commons has been detected. 


CURRENT SEGMENT HAS NOT BEEN DEACTIVATED: The segment that 
should be closed has been left active. 


DUPLICATE SYMBOL DEFINITION ENCOUNTERED: Two definitions have 
been encountered for the same external symbol. 


ENTRY NAME TRUNCATED: The entry name has been truncated to six char- 
acters. This Is a trivial warning and processing proceeds with the truncated name. 


EXTERNAL REFERENCE INDEX OUT OF RANGE: The index number specified 
by an E tag in an input object module is not valid. 


EXTERNAL SYMBOL TRUNCATED: A symbol specified in a GLOBAL or 
NOTGLOBAL command exceeds six characters in length. 


FATAL ERROR DETECTED -- *LINKER ABORTING”: Ahn error that the linker 
cannot recover from has been detected. The user should repeat the process. If the 
message occurs again, then either check the procedures used or call the hotline for 
assistance. 


FIRST PHASE HAS ALREADY BEEN DEFINED: A NOMAP command has 
appeared after a TASK or a PHASE command has been issued in the control stream. 


HEAP ERROR ENCOUNTERED IN PASS2: A heap error was detected while 
trying to allocate data space for the second pass. Indicates a malfunction of the link 
editor; call hotline immediately. 


ILLEGAL INTERMEDIATE TAG ENCOUNTERED AT XXXX: An encoded tag 
was encountered that was not valid. Indicates a malfunction of the link editor; call 
hotline immediately. 


ILLEGAL TAG FOUND IN INTERMEDIATE FILE; TAG=X: An invalid tag was 
found in the intermediate file. Indicates a malfunction of the link editor; call hotline 
immediately. 


INTERMEDIATE FILE OVERFLOW: The maximum number of records for inter- 
mediate object representation has been exceeded. Obtain more file space by making 
individual object modules smaller or call the hotline for assistance. 


INTERMEDIATE RECORD NUMBER INVALID: The record index for the 
intermediate storage is not in the legal range. 
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INTERNAL LINKER ERROR IN AUTOCALL: Ahn error has occurred in the 
automatic-call algorithm. This error should never occur. If it does, unresolved 
references may be the result of modules not having been read in; in other respects, 
the object module produced should be good. Relink using specific INCLUDES for 
the missing modules or call the hotline for assistance. 


INVALID ATTEMPT TO MOVE FIRST COMMON: The linker has attempted 
to move a common that was specified as the first common by a COMMON command. 
Indicates a malfunction of the link editor; call hotline immediately. 


INVALID ATTEMPT TO READ BUFFER: The linker has attempted to activate a 
buffer that is not of the correct type. Indicates a malfunction of the link editor; call 
hotline immediately. 


INVALID LEVEL FOR PHASE: The level argument to a PHASE command is not 
appropriate. The first phase established must be a TASK or a phase of level O. If the 
current level is N, a new phase must have level < N+1. 


INVALID PROCEDURE LEVEL: The level for procedures must be 1 or 2. 
INVALID PROCEDURE SPECIFIED: An illegal procedure has been declared. 


INVALID SYMBOL NAME FOR REPLACE: The REPLACE command has 
encountered an illegal symbol name. 


INVALID VALUE FOR LINES PER PAGE: The argument to a page command 
is not recognized as a positive integer or is out of the range of 16 to 60 lines per page. 


LAST COMMON IN LIST IS NIL: The last common in a list of ordered commons 
does not exist. Indicates a malfunction of the link editor; call hotline immediately. 


LAST MODULE FOR PHASE IS NIL: The linker cannot find the information 
about the current phase. Indicates a malfunction of the link editor; call hotline 
immediately. 


MAP RECORD INDEX IS OUT OF RANGE: The map record is full or the index 
has been changed to an invalid value. Indicates a malfunction of the link editor; call 
hotline immediately. 


MEMBER NAME TOO LONG: The member name exceeds eight characters. The 
command is not processed. 


MEMBER NAME TRUNCATED: The member name has been truncated to eight 
characters. This is a trivial warning and processing proceeds with the truncated name. 


MINIMUM NUMBER OF LINES PER PAGE IS 16: A PAGE N command may 
not specify a value of N less than 16. 


MODULE LENGTH IS ZERO: The length for the module has been incorrectly 
specified as zero. 


MODULE ORIGIN IS NOT ZERO: The origin for a module must be zero before 
the relocation is applied. 


NIL COMMON SEGMENT WAS ACTIVATED: An attempt was made to activate 
a common segment that does not exist. 


NIL SEGMENT FOR M TAG SYMBOL: An M tag definition applies to a segment 
that does not exist. Indicates a malfunction of the link editor; call hotline immediately. 
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NO PHASE IS DEFINED: No PROCEDURE, TASK, or PHASE 0 has been defined. 
A command has been given which requires that object modules be read in or that 
some phase be active. 


NO TASK PHASE IS DEFINED: No TASK or PHASE 0 has been defined. A valid 
set of linked object modules cannot be produced. 


NOTGLOBAL MUST PRECEDE A GLOBAL COMMAND: The GLOBAL 
command is only valid if it is preceded by a NOTGLOBAL command with no 
parameter. 


OBJECT CARD INDEX ERROR DETECTED: After writing an object record, the 
index into the record was not equal to one. Indicates a malfunction of the link editor; 
call hotline immediately. 


ORIGIN CANNOT BE WRITTEN TO INACTIVE SEGMENT: The linker has 
attempted to write origin information to a segment that is not open. Indicates a 
malfunction of the link editor; call hotline immediately. 


OVERWRITTEN BLOCKS FOR XXXX TO YYYY: Absolutely placed object code 
overlaps at the given address. 


OVERWRITTEN SEGMENTS STARTING AT XXXX IN MODULE 
NNNNNNNN: Overlapping segments have been detected starting at location 
XXXX. The link map specifies which segment starts at that point. This is flagged 
as a warning. 


PARTIAL COMMAND INVALID IN CONTEXT: The PARTIAL command was 
specified in the control stream after a command that is inconsistent with partial links 
(e.g... DUMMY, PROGRAM, DATA, COMMON, ALLOCATE, PROCEDURE, PHASE 
1, etc.) 


PHASE LEVEL EXPECTED: The level argument to a PHASE command must be 
a zero Or a positive integer. 


PHASE LEVEL SPECIFIED IS NOT VALID: The level specified in a PHASE 
command is not in the valid range. 


PHASE NAME TRUNCATED: The phase name has been truncated to eight 
characters. This is a trivial warning, and processing proceeds with the truncated 
name. 


PHASE SEQUENCE IS NOT VALID: The order in which the phases have been 
declared is not legal. 


PREMATURE END OF CONTROL FILE: The control file has ended before an 
END command was encountered. No further processing is done. 


PROCEDURE CANNOT HAVE BROTHERS: A procedure cannot have phases 
at the same level defined with it. 


PROCEDURE NAME TRUNCATED: The procedure name has been truncated 
to eight characters. This is a trivial warning, and processing proceeds with the 
truncated name. 


PROC 1 MUST BE DUMMIED TO DUMMY PROC 2: In order to dummy the 
second procedure, the first procedure must also be dummied. 


PROC 1 SYMBOL NUMBER IS NOT ZERO: The symbol number for the 
procedure must be zero. 


PROC 2 SYMBOL NUMBER IS NOT ZERO: The symbol number for the 
procedure must be zero. 


9-53 


Link Editor 


9-54 


RELOCATABLE ADDRESS !S NOT VALID;SEGMENTS SHOULD BE 
PLACED AT ABSOLUTE LOCATIONS: Certain TMS320-specific tags require 
that segments to which they refer be placed at absolute addresses. 


SEGMENT BUFFER HAS BEEN DAMAGED: The current segment does not 
contain the expected information. Indicates a malfunction of the link editor; call 
hotline immediately. 


SEGMENT ORIGIN IS ZERO: The origin for a segment has erroneously changed 
to zero. Indicates a malfunction of the link editor; call hotline immediately. 


TASK OR PHASE 0 IS ALREADY DEFINED: A PROCEDURE command cannot 
be given once a task phase has been defined. 


TASK OR PHASE 0 MUST BE DEFINED BEFORE OVERLAY: An overlay has 
been defined before the task or root phase. 


THE CURRENT SEGMENT IS NIL: The segment that is being examined does 
not exist. Indicates a malfunction of the link editor; call hotline immediately. 


THE INPUT OBJECT MODULE HAS BEEN DAMAGED: Unexpected or invalid 
tags and values have been encountered in the input object module. 


THE MAP RECORD IS NIL: An attempt has been made to place information into 
the map record when the record does not exist. Indicates a malfunction of the link 
editor; call hotline immediately. 


THE OVERWRITTEN BLOCKS ARE NOT COMPATIBLE: The types of the 
overlapping blocks are not the same, and a valid object module cannot be produced. 


THE PHASE TYPE IS NOT TASK, OVLY, OR PROC: This error should never 
occur, because the only valid types are TASK, OVLY, and PROC. 


THE SEGMENT TYPE IS NOT PSEG, DSEG, OR CSEG: The only valid segment 
types are PSEG, DSEG, and CSEG. 


TOO MANY SYMBOLS HAVE BEEN DEFINED: The statically allocated arrays 
that contain the values for symbols (mostly external symbols and phase lengths, 
origins, etc.) have overflowed. The number of symbols allowed in a symbol table is 
1110. 


UNABLE TO PROPERLY ORDER COMMONS: The linker cannot order the 
commons as specified. 


UNEXPECTED TAG: The input object module is not of the expected format. It 
may not really be an object module. Processing stops. 


UNRECOGNIZED FORMAT: The argument to the FORMAT command is not 
recognized. 


UNRECOGNIZED COMMAND: The command on the most recent line is not 
recognized as a linker command. The line is ignored. 


UNSUPPORTED INTER-SEGMENT LINK FOR XXXX FROM YYYY TO 
ZZZZ: This message is printed by the second pass, and applies to the module in 
the linked output that is next identified. An external reference chain has pointed from 
one PSEG, DSEG, or CSEG into another. XXXX is the value of the external symbol 
to be filled in. (The second pass cannot identify it by symbol name. The name can 
often be found by examining the symbol definitions. A symbol with a value of zero 
may be an unresolved reference.) YYYY, the address where the chain starts, identifies 
the offending module. ZZZZ is the address to which the chain points. The only 
deficiency in the linked object is that incorrect values remain where the value of 
external symbol XXXX should have been inserted. 
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Sixteen Input and Sixteen Output Channels 


16-Bit Parallel Interface 


Directly Accessible External Data Memory 
Space 
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Block Moves for Data/Program Management 


Repeat Instructions for Efficient Use of 
Program Space 


Eight Auxiliary Registers and Dedicated 
Arithmetic Unit for Indirect Addressing 


Serial Port for Direct Codec Interface 


Synchronization Input for Synchronous 
Multiprocessor Configurations 


Wait States for Communication to Slow 
Off-Chip Memories/Peripherals 


On-Chip Timer for Control Operations 
Three External Maskable User Interrupts 


Input Pin Polled by Software Branch 
Instruction 


Programmable Output Pin for Signalling 
External Devices 


1.8-u4m CMOS Technology 
Single 5-V Supply 
On-Chip Clock Generator 
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PIN NOMENCLATURE 


| gignats ~—s|_-wovzt DEFINITION 


5-V supply pins 


Ground pins 


Output from internal oscillator for crystal 


X2/CLKIN 
CLKOUT1 
CLKOUT2 
D15-DO 


Input to internal oscillator from crystal or external clock 
Master clock output (crystal or CLKIN frequency/4) 


A second clock output signal 

16-bit data bus D15 (MSB) through DO (LSB). Multiplexed between program, data, and I/O 
spaces. 

16-bit address bus A15 (MSB) through AO (LSB) 

Program, data, and |/O space select signals 


Read/write signal 

Strobe signal 

Reset input 

External user interrupt inputs 
Microprocessor/microcomputer mode select pin 
Microstate complete signal 

Interrupt acknowledge signal 

Data ready input. Asserted by external logic when using slower devices to indicate that the 
current bus transaction is complete. 

Bus request signal. Asserted when the TMS320C25 requires access to an external global 
data memory space. 

External flag output (latched software-programmable signal) 

Hold input. When asserted, TMS320C25 goes into an idle mode and places the data, address, 
and control lines in the high-impedance state. 

Hold acknowledge signal 

Synchronization input 

Branch control input. Polled by BIOZ instruction. 

Serial data receive input 

Clock for receive input for serial port 

Frame synchronization pulse for receive input 

Serial data transmit output 

Clock for transmit output for serial port 

Frame synchronization pulse for transmit. Configurable as either an input or an output. 


t1/O/Z denotes input/output/high-impedance state. 


description 


The TMS320C25 Digital Signal Processor is a member of the TMS320 family of VLSI digital signal processors 
and peripherals. The TMS320 family supports a wide range of digital signal processing applications, such 
as telecommunications, modems, image processing, speech processing, spectrum analysis, audio 
processing, digital filtering, high-speed control, graphics, and other computation-intensive applications. 


With a 100-ns instruction cycle time and an innovative memory configuration, the TMS320C25 performs 
operations necessary for many real-time digital signal processing algorithms. Since most instructions require 
only one cycle, the TMS320C25 is capable of executing ten million instructions per second. On-chip data 
RAM of 544 16-bit words, on-chip program ROM of 4K words, direct addressing of up to 64K words of 
external data memory space and 64K words of external program memory space, and multiprocessor 
interface features for sharing global memory minimize unnecessary data transfers to take full advantage 
of the capabilities of the processor. 
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functional block diagram 
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A-3 


Global memory allocation register 
= Serial port receive shift register 
= Serial port transmit shift register 


Status registers 


Program counter 


= Prefetch counter 
= Repeat instruction counter 


ARO-AR7 = Auxiliary registers 


PC 

PFC 
RPTC 
GREG 
RSR 
XSR 
STO,ST1 
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FIGURE 3-1. 
STRUMENTS 


Interrupt flag register 
= Instruction register 


Temporary register 


Timer 


= Queue instruction register 


= Product register 


= Period register for timer 


IN 


MCS = Microcall stack 
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IMR 
IR 
QiR 
PR 
PRD 
TIM 
TR 


Auxiliary register pointer buffer 


Accumulator high 
= Auxiliary register pointer 


Accumulator low 


= Arithmetic logic unit 
= Serial port data receive register 


= Auxiliary register arithmetic unit 
= Serial port data transmit register 


= Data memory page pointer 


LEGEND: 
ACCH 
ACCL 
ALU 
ARAU 
ARB 
ARP 
DP 
DRR 
DXR 
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architecture 


The TMS320C25 architecture is based upon that of the TMS32020, the second member of the TMS320 
family. The TMS320C25 increases performance of DSP algorithms through innovative additions to the 
TMS320 family architecture. TMS32020 source code is upward-compatible with TMS320C25 source code 
and can be assembled using the TMS320C25 Macro Assembler. TMS32020 object code will run directly 
on the TMS320C25. 


Increased throughput on the TMS320C25 for many DSP applications is accomplished by means of single- 
cycle multiply/accumulate instructions with a data move option, eight auxiliary registers with a dedicated 
arithmetic unit, and faster I/O necessary for data-intensive signal processing. 


The architectural design of the TMS320C25 emphasizes overall speed, communication, and flexibility in 
processor configuration. Control signals and instructions provide floating-point support, block-memory 
transfers, communication to slower off-chip devices, and multiprocessing implementations. 


Two large on-chip RAM blocks, configurable either as separate program and data spaces or as two 
contiguous data blocks, provide increased flexibility in system design. Programs of up to 4K words can 
be masked into the internal program ROM. The remainder of the 64K-word program memory space is located 
externally. Large programs can execute at full speed from this memory space. Programs can also be 
downloaded from slow external memory to high-speed on-chip RAM. A total of 64K data memory address 
space is included to facilitate implementation of DSP algorithms. The VLSI implementation of the 
TMS320C25 incorporates all of these features as well as many others, such as a hardware timer, serial 
port, and block data transfer capabilities. | 


32-bit ALU/accumulator 


The TMS320C25 32-bit Arithmetic Logic Unit (ALU) and accumulator perform a wide range of arithmetic 
and logical instructions, the majority of which execute in a single clock cycle. The ALU executes a variety 
of branch instructions dependent on the status of the ALU or a single bit in a word. These instructions 
provide the following capabilities: 


e Branch to an address specified by the accumulator 
e Normalize fixed-point numbers contained in the accumulator 
e Test a specified bit of a word in data memory. 


One input to the ALU is always provided from the accumulator, and the other input may be provided from 
the Product Register (PR) of the multiplier or the input scaling shifter which has fetched data from the 
RAM on the data bus. After the ALU has performed the arithmetic or logical operations, the result is stored 
in the accumulator. 


The 32-bit accumulator is split into two 16-bit segments for storage in data memory. Additional shifters 
at the output of the accumulator perform shifts while the data is being transferred to the data bus for 
storage. The contents of the accumulator remain unchanged. 


scaling shifter 


The TMS320C25 scaling shifter has a 16-bit input connected to the data bus and a 32-bit output connected 
to the ALU. The scaling shifter produces a left shift of O to 16 bits on the input data, as programmed 
in the instruction. The LSBs of the output are filled with zeroes, and the MSBs may be either filled with 
zeroes or sign-extended, depending upon the status programmed into the SXM (sign-extension mode) bit 
of status register STO. 
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16 x 16-bit parallel multiplier 


The TMS320C25 has a 16 x 16-bit hardware multiplier, which is capable of computing a signed or unsigned 
32-bit product in a single machine cycle. The multiplier has the following two associated registers: 


e A 16-bit Temporary Register (TR) that holds one of the operands for the multiplier, and 
e A 32-bit Product Register (PR) that holds the product. 


Incorporated into the TMS320C25 instruction set are single-cycle multiply/accumulate instructions that 
allow both operands to be processed simultaneously. The data for these operations may reside anywhere 
in internal or external memory, and can be transferred to the multiplier each cycle via the program and 
data buses. 


Four product shift modes are available at the Product Register (PR) output that are useful when performing 
multiply/accumulate operations, fractional arithmetic, or justifying fractional products. 


timer 


The TMS320C25 provides a memory-mapped 16-bit timer for control operations. The on-chip timer (TIM) 
register is a down counter that is continuously clocked by CLKOUT 1. A timer interrupt (TINT) is generated 
every time the timer decrements to zero. The timer is reloaded with the value contained in the period (PRD) 
register within the next cycle after it reaches zero so that interrupts may be programmed to occur at regular 
intervals of PRD +1 cycles of CLKOUT1. 


memory control 


The TMS320C25 provides a total of 544 16-bit words of on-chip data RAM, divided into three separate 
blocks (BO, B1, and B2). Of the 544 words, 288 words (blocks B1 and B2) are always data memory, and 
256 words (block BO) are programmable as either data or program memory. A data memory size of 544 
words allows the TMS320C25 to handle a data array of 512 words (256 words if on-chip RAM is used 
for program memory), while still leaving 32 locations for intermediate storage. When using block BO as 
program memory, instructions can be downloaded from external program memory into on-chip RAM and 
then executed. 


When using on-chip program RAM, ROM, or high-speed external program memory, the TMS320C25 runs 
at full speed without wait states. However, the READY line can be used to interface the TMS320C25 
to slower, less-expensive external memory. Downloading programs from slow off-chip memory to on-chip 
program RAM speeds processing while cutting system costs. 


The TMS320C25 provides three separate address spaces for program memory, data memory, and I/O. 
The on-chip memory is mapped into either the 64K-word data memory or program memory space, depending 
upon the memory configuration. The CNFD (configure block BO as data memory) and CNFP (configure 
block BO as program memory) instructions allow dynamic configuration of the memory maps through 
software. Regardless of the configuration, the user may still execute from external program memory. 


The TMS320C25 has six registers that are mapped into the data memory space: a serial port data receive 
register, serial port data transmit register, timer register, period register, interrupt mask register, and global 
memory allocation register. 
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FIGURE 1. MEMORY MAPS 
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interrupts and subroutines 


The TMS320C25 has three external maskable user interrupts INT2-INTO, available for external devices that 
interrupt the processor. Internal interrupts are generated by the serial port (RINT and XINT), by the timer 
(TINT), and by the software interrupt (TRAP) instruction. Interrupts are prioritized with reset (RS) having 
the highest priority and the serial port transmit interrupt (XINT) having the lowest priority. All interrupt 
locations are on two-word boundaries so that branch instructions can be accommodated in those locations 
if desired. 


A built-in mechanism protects multicycle instructions from interrupts. If an interrupt occurs during a 
multicycle instruction, the interrupt is not processed until the instruction is completed. This mechanism 
applies both to instructions that are repeated or become multicycle due to the READY signal. 


external interface 


The TMS320C25 supports a wide range of system interfacing requirements. Program, data, and I/O address 
spaces provide interface to memory and I/O, thus maximizing system throughput. I/O design is simplified 
by having |/O treated the same way as memory. |/O devices are mapped into the I/O address space using 
the processor’s external address and data busses in the same manner as memory-mapped devices. Interface 
to memory and I/O devices of varying speeds is accomplished by using the READY line. When transactions 
are made with slower devices, the TMS320C25 processor waits until the other device completes its function 
and signals the processor via the READY line. Then, the TMS320C25 continues execution. 


A serial port provides communication with serial devices, such as codecs, serial A/D converters, and other 
serial systems. The interface signals are compatible with codecs and many other serial devices with a 
minimum of external hardware. The serial port may also be used for intercommunication between processors 
in multiprocessing applications. 


The serial port has two memory-mapped registers: the data transmit register (DXR) and the data receive 
register (DRR). Both registers operate in either the byte mode or 16-bit word mode, and may be accessed 
in the same manner as any other data memory location. Each register has an external clock, a framing 
synchronization pulse, and associated shift registers. One method of multiprocessing may be implemented 
by programming one device to transmit while the others are in the receive mode. 


multiprocessing 


The flexibility of the TMS320C25 allows configurations to satisfy a wide range of system requirements. 
The TMS320C25 can be used as follows: 


e A standalone processor 

e A multiprocessor with devices in parallel 

e A slave/host multiprocessor with global memory space 

e A peripheral processor interfaced via processor-controlled signals to another device. 


For multiprocessing applications, the TMS320C25 has the capability of allocating global data memory space 
and communicating with that space via the BR (bus request) and READY control signals. Global memory 
is data memory shared by more than one processor. Global data memory access must be arbitrated. The 
8-bit memory-mapped GREG (global memory allocation register) specifies part of the TMS320C25's data 
memory as global external memory. The contents of the register determine the size of the global memory 
space. If the current instruction addresses an operand within that space, BR is asserted to request control 
of the bus. The length of the memory cycle is controlled by the READY line. 


The TMS320C25 supports DMA (direct memory access) to its external program/data memory using the 
HOLD and HOLDA signals. Another processor can take complete control of the TMS320C25’s external 
memory by asserting HOLD low. This causes the TMS320C25 to place its address, data, and control 
lines in a high-impedance state, and assert HOLDA. 
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instruction set 


The TMS320C25 microprocessor implements a comprehensive instruction set that supports both numeric- 
intensive signal processing operations as well as general-purpose applications, such as multiprocessing 
and high-speed control. The TMS32020 source code is upward-compatible with TMS320C25 source code. 
TMS32020 object code runs directly on the TMS320C25. 


For maximum throughput, the next instruction is prefetched while the current one is being executed. Since 
the same data lines are used to communicate to external data/program or I/O space, the number of cycles 
may vary depending upon whether the next data operand fetch is from internal or external program memory. 
Highest throughput is achieved by maintaining data memory on-chip and using either internal or fast external 
program memory. 


addressing modes 


The TMS320C25 instruction set provides three memory addressing modes: direct, indirect, and immediate 
addressing. 


Both direct and indirect addressing can be used to access data memory. In direct addressing, seven bits 
of the instruction word are concatenated with the nine bits of the data memory page pointer to form the 
16-bit data memory address. Indirect addressing accesses data memory through the eight auxiliary registers. 
In immediate addressing, the data is based on a portion of the instruction word(s). 


In direct memory addressing, the instruction word contains the lower seven bits of the data memory address. 
This field is concatenated with the nine bits of the data memory page pointer to form the full 16-bit address. 
Thus, memory is paged in the direct addressing mode with a total of 512 pages, each page containing 
128 words. 


Eight auxiliary registers (ARO-AR7) provide flexible and powerful indirect addressing. To select a specific 
auxiliary register, the Auxiliary Register Pointer (ARP) is loaded with a value from O through 7 for ARO 
through AR7, respectively. 


There are seven types of indirect addressing: auto-increment or auto-decrement, post-indexing by either 
adding or subtracting the contents of ARO, single indirect addressing with no increment or decrement, 
and bit-reversal addressing (used in FFTs) with increment or decrement. All operations are performed on 
the current auxiliary register in the same cycle as the original instruction, followed by a new ARP value 
being loaded. 


repeat feature 


A repeat feature, used with instructions such as multiply/accumulates, block moves, |/O transfers, and 
table read/writes, allows a single instruction to be performed up to 256 times. The repeat counter (RPTC) 
is loaded with either a data memory value (RPT instruction) or an immediate value (RPTK instruction). The 
value of this operand is one less than the number of times that the next instruction is executed. Those 
instructions that are normally multicycle are pipelined when using the repeat feature, and effectively become 
single-cycle instructions. 


instruction set summary 


Table 1 lists the symbols and abbreviations used in Table 2, the instruction set summary. Table 2 consists 
primarily of single-cycle, single-word instructions. Infrequently used branch, I/O, and CALL instructions 
are multicycle. The instruction set summary is arranged according to function and alphabetized within each 
functional grouping. The symbol (T) indicates those instructions that are not included in the TMS32010 
instruction set. The symbol (+) indicates instructions that are not included in the TMS32020 instruction set. 
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TABLE 1. INSTRUCTION SYMBOLS 


SYMBOL aif Tauhta¥i 30vas7135 MEAMINBRG TAMIR | 


4-bit field specifying a bit code 

2-bit field specifying compare mode 

Data memory address field 

Format status bit 

Addressing mode bit 

Immediate operand field 

Port address (PAO through PA15 are predefined 


assembler symbols equal to O through 15, respectively.) 


2-bit field specifying P register output shift code 
3-bit operand field specifying auxiliary register 
4-bit left-shift code 

3-bit accumulator left-shift field 
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TABLE 2. TMS320C25 INSTRUCTION SET SUMMARY 


ACCUMULATOR MEMORY REFERENCE INSTRUCTIONS 


NO. INSTRUCTION BIT CODE 
WORDS 


MNEMONIC DESCRIPTION 
t2946-13.121110 9 8 765 4-3 210 
Absolute value of accumulator 
Add to accumulator with shift 
Add to accumulator with carry 
Add to high accumulator 
Add to accumulator short immediate 
Add to low accumulator with sign 
extension suppressed 
Add to accumulator with shift specified by 
T register 
Add to accumulator long immediate with shift 
AND with accumulator 
AND immediate with accumulator with shift 
Complement accumulator 


=a: J Soe ED 


Load accumulator with shift 

Load accumulator immediate short 

Load accumulator with shift specified by T register 
Load accumulator long immediate with shift 
Negate accumulator 

Normalize contents of accumulator 

OR with accumulator 

OR immediate with accumulator with shift 

Rotate accumulator left 

Rotate accumulator right 

Store high accumulator with shift 

Store low accumulator with shift 

Subtract from accumulator long immediate with shift 
Shift accumulator left 

Shift accumulator right 

Subtract from accumulator with shift 

Subtract from accumulator with borrow 
Conditional subtract 


----o00--o000-=+00 —- 


Subtract from high accumulator 


Subtract from accumulator short immediate 


= = 9 = = a = = AQ =| =| = = AQ =| —| =| /H —] — —| —| VY — PN 
Oo. © © 6 © 00.0.0 4- =) 0 0 & © © 0: 6.0 0 20 © © 
o Oo.0'°Oo 8:~ © © = 6'9 <0 0 = 00 O20 0 Oo OC = © 


Subtract from low accumulator with sign 
extension suppressed 

Subtract from accumulator with shift specified by 
T register 

Exclusive-OR with accumulator 

Exclusive-OR immediate with accumulator with shift 
Zero accumulator 

Zero low accumulator and load high accumulator 
Zero low accumulator and load high accumulator 
with rounding 

Zero accumulator and load low accumulator with 


sign extension suppressed 


tThese instructions are not included in the TMS32010 instruction set. 
tThese instructions are not included in the TMS32020 instruction set. 
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TABLE 2. TMS320C25 INSTRUCTION SET SUMMARY (CONTINUED) 


MNEMONIC 


AUXILIARY REGISTERS AND DATA PAGE POINTER INSTRUCTIONS 


DESCRIPTION 


Add to auxiliary register short immediate 


Compare auxiliary register with auxiliary register ARO 


Load auxiliary register 

Load auxiliary register short immediate 

Load auxiliary register pointer 

Load data memory page pointer 

Load data memory page pointer immediate 
Load auxiliary register long immediate 

Modify auxiliary register 

Store auxiliary register 

Subtract from auxiliary register short immediate 


NO. 
WORDS 


= =| ee A —- —| —- = — — — 


oOo - - OO" O-- Oo 


© 


-= .}- Oododo o0dod0o=. 0-2 


INSTRUCTION BIT CODE 


1514131211109 876543210 


T REGISTER, P REGISTER, AND MULTIPLY INSTRUCTIONS 


1 
6) 
) 


j 


oc 


6) 
1 


1 
6) 


1 
| 


Oe) 1 «-h- 
SES, Veneer 


QO pe 
ear OO O° 0 0 0 OU 


0 


1 


1 


ee 
+ —_—_)D——_» 


ESR | ene | 


NO. 
WORDS 


INSTRUCTION BIT CODE 


INSTRUMENTS 
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MNEMONIC DESCRIPTION 

15 1413121110 89:8 7-6 5-4-3 21 ® 
APAC Add P register to accumulator 1 1 Oe ee a a ee 
LPHT Load high P register 1 01010011 1 «<——Dp— >» 
LT Load T register 1 00111100) ——D-—— Pr 
LTA Load T register and accumulate previous product 1 00 11°71 PO rr > 
LTD Load T register, accumulate previous product, 1 0014111131318 ——D—— Pr 

and move data 
LTpT Load T register and store P register in accumulator 1 001141111041 *———)—<—> 
LTst Load T register and subtract previous product 1 0103110311 1 ¢——)D———>r 
MAct Multiply and accumulate 2 010313131031 i!) «&——D—> 
MAcDt Multiply and accumulate with data move 2 01011100 1 «——D—— > 
MPY Multiply (with T register, store product in P register) 1 00 137 1. 0°0O.0- be 
MPYA+ Multiply and accumulate previous product 1 0011101 0t1—«———D-———> 
MPYK Multiply immediate 1 101<#®———_——K——————_> 
MPYS?# Multiply and subtract previous product 1 00111031411 -———Dp—— > 
mPYuUt Multiply unsigned 1 11001111 1 «——Dp——> 
PAC Load accumulator with P register 1 1 eo eee Soe OE ee 
SPAC Subtract P register from accumulator 1 1 1.8.0 7. :P Pa eee 1) 8 eee 
SPH? Store high P register 1 0O11%1%1%10O0%14 | #———D)— > 
SPL# Store low P register 1 011111001 <«—pD—-»> 
spmt Set P register output shift mode 1 1100111000001 0<PME 
SOQRAT Square and accumulate 1 00114310011“ —D— > 
sarst Square and subtract previous product 1 01031%10%310%4!*#——D—_—-> 
TThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 
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TABLE 2. TMS320C25 INSTRUCTION SET SUMMARY (CONTINUED) 


MNEMONIC 


BRANCH/CALL INSTRUCTIONS 


DESCRIPTION 


Branch unconditionally 

Branch to address specified by accumulator 
Branch on auxiliary register not zero 
Branch if TC bit + O 

Branch if TC bit = O 

Branch on carry 

Branch if accumulator > O 

Branch if accumulator > O 

Branch on 1/O status = O 

Branch if accumulator < O 

Branch if accumulator < O 

Branch on no carry 

Branch if no overflow 

Branch if accumulator + O 

Branch on overflow 


II 
© 


Branch if accumulator 
Call subroutine indirect 
Call subroutine 

Return from subroutine 


NO. 
WORDS 


—- NO —_-?~ NNN N ND NYMN NN NY NY NY NY YM — ND 


ee ee ee ee eee ee ee ee ee ee ee ee ee ee ee ee ee | 


1/0 AND DATA MEMORY OPERATIONS 


; SE Sang 


— 2 O OG O i. 30.0624 [OCOt Ss a ae RS 
=> ee OO ee LE SOMO 4 OO deta 
at Oe ait ek ee SOC OC Siena 
G 0.620 0 = & 6I54050 070705002540 


INSTRUCTION BIT CODE 


18.4442 121710 8 8.7.65 43 2 17 0 


Ee Ca 
S48) 4. 


MNEMONIC 


BLKD 
BLKPT 
DMOV 
FORT? 
IN 
OUT 
RFSM+ 
RTXMTt 
RxFT 
SFSMt 
STXMT 
SXFt 
TBLR 
TBLW 


TThese instructions are not included in the TMS32010 instruction set. 
tThese instructions are not included in the TMS32020 instruction set. — 
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DESCRIPTION 


Block move from data memory to data memory 
Block move from program memory to data memory 


Data move in data memory 
Format serial port registers 
Input data from port 


_ Output data to port 


Reset serial port frame synchronization mode 
Reset serial port transmit mode 

Reset external flag 

Set serial port frame synchronization mode 
Set serial port transmit mode 

Set external flag 

Table read 

Table write 
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NO. 
WORDS 


2 
2 
1 
; 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 


a > i a a a 


oo ooo o oo +/000 + 2 


- .}- Ooo cdd°doo0og*jcecos.-- = 


: EG ee 
Oe ae. 


2 OOO" © 10%0O70O7;O0 


ee ye 4) oe a ae ee ey, ey eS 
Ooor.- = =2s-+ —- = 
oOoo-+ +2 2 2 — — 


| 
| 
0 
| 
| 
¢) 
0 
0 
6) 
0 
0 
| 
| 


INSTRUCTION BIT CODE 


16 14131211109 8 76543 21.0 


Alea orvortesiccioniiie 
Ss | 
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TABLE 2. TMS320C25 INSTRUCTION SET SUMMARY (CONCLUDED) 


CONTROL INSTRUCTIONS 


MNEMONIC saieicenetia NO. INSTRUCTION BIT CODE 
WORDS 


1514131211109 8 76543210 
Test bit 001~<«—sB-—> | 
Test bit specified by T register 
Configure block as data memory 
Configure block as program memory 
Disable interrupt 
Enable interrupt 
Idle until interrupt 
Load status register STO 
Load status register ST1 
No operation 
Pop top of stack to low accumulator 
Pop top of stack to data memory 
Push data memory value onto stack 
Push low accumulator onto stack 
Reset carry bit 
Reset hold mode 
Reset overflow mode 


— © © -O40 =- = © 90 = -- 60°70; 0:2 0°— 


Repeat instruction as specified by data memory value 
Repeat instruction as specified by immediate value 
Reset sign-extension mode 

Reset test/control flag 

Set carry bit 

Set hold mode 

Set overflow mode 

Store status register STO 

Store status register ST1 

Set sign-extension mode 

Set test/control flag 


Se ae ee ee ee ee ee” ee ee ee ee ee ee ee ee Ve ie a ce ee hee a ae eee ee ee a ee 


oo ore 90 ONO OCOOooocnoeoCgco0oT0oni0c-e-0000.0'0-0 08 006 


oo or rr 0 00 00 00 0 00 CO fF |S Oo-rre ]S]? ONnoNnenNnoNJ7 = 
ee co a o> a © a a Se a Se 2 @ | 


oo ofr70o0000oo efrxeerer0e0oe0oe0e0cn0ceqoe+rrerlt0000002+ 


oo °o =—- = 2°00 ©-f 


5 
; 
; 
; 
1 
1 
6) 
0 
1 
1 
0 
1 
1 
1 
1 
1 
0 
O 
1 
1 
1 
1 
1 
) 
0 
1 
1 
1 


Ce ee ee ee ee ee ee ee ee ee ee ee ee Se ee ee a a a a Sa a | 


Software interrupt 


TThese instructions are not included in the TMS32010 instruction set. 
tThese instructions are not included in the TMS32020 instruction set. 
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development systems and software support 


Texas Instruments offers concentrated development support and complete documentation for designing 
a TMS320C25-based microprocessor system. When developing an application, tools are provided to 
evaluate the performance of the processor, to develop the algorithm implementation, and to fully integrate 
the design’s software and hardware modules. When questions arise, additional support can be obtained 
by calling the nearest Texas Instruments Regional Technology Center (RTC). 


Sophisticated development operations are performed with the TMS320C25 Macro Assembler/Linker, 
Simulator, and Emulator (XDS). The macro assembler and linker are used to translate program modules 
into object code and link them together. This puts the program modules into a form which can be loaded 
into the TMS320C25 Simulator or Emulator. The simulator provides a quick means for initially debugging 
TMS320C25 software while the emulator provides the real-time in-circuit emulation necessary to perform 
system level debug efficiently. 


Table 3 gives a complete list of TMS320C25 software and hardware development tools. 


TABLE 3. TMS320C25 SOFTWARE AND HARDWARE SUPPORT 


ne eee ere a ee es eee 


EMULATORS 
oe tt ig ee ae aie 
XDS/22 Included TMDS3262221 
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absolute maximum ratings over specified temperature range (unless otherwise noted) t 


I SN BN Eoin he a a Se ee RA 6 42 6s A ee -O0.3Vto7V 
an Se Te ieee be ee Ee Oe ee ee Pee ee Ee PPO Pee Serer -0.3 Vto7V 
i ee FS ac Sk ce Pw ee Re ee ORD ee wee SRW kee ed ¥ e -0.3 Vto7V 
ee Re re METERED ben Gow ae oe ke 8 OR Se 8 ee 0 ee Cole Bees Fe ee 1.5 W 
Operating iree-aw temperature range Pe ee OS SLI OFC 10 :70°C 
Die Tee tane TOG se rk ee ORR Dee on kr ee er es SFO SE we ~ 55°C 'to°150 °C 


TStresses beyond those listed under ‘‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating 
only and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions’’ section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. 

+All voltage values are with respect to Ves. 


recommended operating conditions 


Vcc Supply voltage 
Vss Supply voltage 
All inputs except CLKIN 
Hie aver ingin vekage Voc +0.3 


VIH 


VIL 


IOH High-level output current 300 
io ____Low-level output current Co 2 ere 
TA Operating free-air temperature 


electrical characteristics over specified free-air temperature range (unless otherwise noted) 


PARAMETER TEST CONDITIONS MIN TYP’ MAX | UNIT 
OH High-level output voltage Vcc = MIN, lon = MAX 
VOL Low-level output voltage Vcc = MIN, lo, = MAX eee ae ee 
| 
O 


Low-level input voltage 


input current ——SSS~*~*~irSC‘ = egg to og SSOSCS~S = TOSSOS~SO Yn 
Ta = 0°C, Voc = MAX, fy = MAX 180 
alae peikwel MMMM oi ets diy ohracti eens Gainacs adaienns ches ce Mee a 

eo oe yO ee nee 


TAIl typical values are at Vcc = 5 V, Ta = 25°C. 


V 
IZ Three-state current Vcc = MAX - 20 20 
I 
C 


«& Caution. This device contains circuits to protect its inputs and outputs against damage due to high static voltages or electrostatic 
y VAN fields. These circuits have been qualified to protect this device against electrostatic discharges (ESD) of up to 2 kV according 
to MIL-STD-883C, Method 3015; however, it is advised that precautions be taken to avoid application of any voltage higher than maximum 
rated voltages to these high-impedance circuits. During storage or handling, the device leads should be shorted together or the device 
should be placed in conductive foam. In a circuit, unused inputs should always be connected to an appropriate logic voltage level, preferrably 
either Vcc or ground. Specific guidelines for handling devices of this type are contained in the publication ‘Guidelines for Handling Electrostatic- 
Discharge Sensitive (ESDS) Devices and Assemblies’’ available from Texas Instruments. 
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CLOCK CHARACTERISTICS AND TIMING 


The TMS320C25 can use either its internal oscillator or an external frequency source for a clock. 
internal clock option 


The internal oscillator is enabled by connecting a crystal across X1 and X2/CLKIN (see Figure 2). The 
frequency of CLKOUT1 is one-fourth the crystal fundamental frequency. The crystal should be fundamental 
mode, and parallel resonant, with an effective series resistance of 30 ohms, a power dissipation of 1 mW, 
and be specified at a load capacitance of 20 pF. 


CRYSTAL 


E U 
T i C2 


FIGURE 2. INTERNAL CLOCK OPTION 
external clock option 


An external frequency source can be used by injecting the frequency directly into X2/CLKIN with X11 left 
unconnected. The external frequency injected must conform to the specifications listed in the following table. 


switching characteristics over recommended operating conditions (see Note 1) 


PARAMETER 


100 97 | re 
Pe ROI ee pee ay at 
hs MEME cl 
penis? <I 
oe 


twiCL) CLKOUT 1/CLKOUT2 low pulse duration 20-8 20 20+8 
tw(CH) CLKOUT1/CLKOUT2 high pulse duration 20-8 20 20+8 
td(C1-C2) CLKOUT1 high to CLKOUT2 low, CLKOUT2 high to CLKOUT1 high, etc. Q-5 


NOTE 1:Q = 1/4te(¢). 
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timing requirements over recommended operating conditions (see Note 1) 


MIN NOM MAX | UNIT 


te(Cl) CLKIN cycle time 

t#(Cll) CLKIN fall time 

tr(Cl) CLKIN rise time 

twi(CIL) CLKIN low pulse duration, tc(cj) = 50 ns (Note 2) 
tw(CIH) CLKIN high pulse duration, te(c}) = 50 ns (Note 2) 
tsu(S) SYNC setup time before CKLIN low 


th(S) SYNC hold time from CLKIN low 


NOTES: 1.Q = 1/4tg¢). 
2. CLKIN duty cycle [tr(cj) + tw(CIH)]/tce(c}) Must be within 40-60%. 


2.15 V 


Ri = 8250 


FROM OUTPUT 
UNDER TEST TEST 
POINT 


T Cy = 100 pF 


FIGURE 3. TEST LOAD CIRCUIT 


==> sons come cum. Game —— Vin (MIN) 


8: hop Met Oe tae eR Vit (MAX) 


(a) INPUT 


—— —— Voy (MIN) 


0.6V~ acne ASRS SOE Voit (MAX) 


(b) OUTPUTS 


FIGURE 4. VOLTAGE REFERENCE LEVELS 
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clock timing 


rt tc(C1)—™1 


—-| metric) 
wad wal : 


ae SESS 2S Ws Ss aT wee 
| | | ar 


[ 
l | | { | | | 
bt» —-—4- t ——e_r | | 
l ae {| | bee tw (CIH) 
Sync \ | | 
| : | td(CIH-C) t=" 
‘ SEeREreeeiee ss 0S See 
7 ——o| td(CIH-C) | ST Oe! 
I : bie ter : 
CLKOUT1 : | | i/\ iN 
| 3 ; oe cree 
: 7 F=—t td(CIH-C) : — Le tric) eel =—t#(C) 
l | 
STRB | \ : yy, 7 
| { | 
ed ee ta CIH C) | Qh 3s 2 CE Se, ba ee | 
| 
: l : ote 
CLKOUT2 7 7 | | 7 ) 
| 
| | btw (cH) ——> | ee 
ke t(C1-C2) | bee te (C1-C.2)-0l |! eee te oes 
| rm=td(C1-C2) 4 Se | r 
™tq(C1-C2)=— me—tt(C) 
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MEMORY AND PERIPHERAL INTERFACE TIMING 


switching characteristics over recommended operating conditions (see Note 1) 


thia) Address hold time after STRB high (Note 3) ee See 


tw(SL) STRB low pulse duration (no wait states, Note 4) 


tsu(D)W Data write setup time before STRB high (no wait states) 
a 
tenio) Data bus starts being driven after STRB low (wie cycle) SiS 


td(MSC) MSC valid from CLKOUT 1 aa fe 0 12 


NOTES: 1.Q = 1/4tgic). 
3. A15-AO, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address.”’ 
4. Delays between CLKOUT 1/CLKOUT2 edges and STRB edges track each other, resulting in tw(SL) and tw(SH) being 20 with 
no wait states. 


timing requirements over recommended operating conditions (see Note 1) 


ta(A) Read data access time from address time (read cycle, Notes 3 and 5) 30-35 


ae 
th ane ec a Lace 
a aaa ee 
raisin) READY vol attr S1WVow ino waren SSS | re 
Ttaic2H-A) READY valid efter CLKOUTZ high SSS SSCS 20 |_| 
Sim) READY tell dee atte BTW ow Go netsae) SS ed 
tniGou- Ry READY hold efter CLKOUTZRgR A SCSCS~C*‘“*“S*~*‘ir Sid 
MISC val ne 

es 


td(M-R) READY valid after MSC valid 20-25 


th(M-R) READY hold time after MSC valid 


NOTES: 1. Q = 1/4tgc). 
3. A15-A0, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address.”’ 
5. Read data access time is defined as ta(A) = tsy(A) + tw(SL) — tsu(D)R- 
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memory read timing 
eeey or 
| 


| 
CLKOUT1 | | | 
| 

| 


he—td(C1-S)—— 


| 
CLKOUT2 \ /' \ | / 
| | 


| 
! 

-- a Pen ie 
| 


}-—twisH}—=4 
| batt 
| hep t yy (SL) ———om | h(A) 


A15-A0 
BER EN «Gets 4; (XxX) (XR 
OR iS WY OO" 
aia : ! 
wn XXXXX¥ x x XX Y 
= AY Pteuirin—ey 


td(SL-R) 7 


ae 26 
et 


READY KKK | ERK KKK 
m thisL-R) ralneoreane 


i 
DATA 


memory write timing 


CLKOUT1 se Neher 
cLKouT2 \ / \ / 


am = tsuia) - = thi(A) 


A15-A0 7) VAY, 
PB ei raky OX») XX) 
BR,PS,DS, OX KK | VALID IXXXX?} 
OR is CX $.4.¢ 
| 
| | l 
‘ee a 
Sed \/ XX » | | OOO 
RW eo : | KR KN, 
| 
| | 
XXX KX \/ xX \/ ~ KX XXX XY XXX XX \/ XXX X XxX Vavay, xXx \/ “x ) 
READY OK K KKK L YY KKK KKK) 


KX 
OY) 


D15-DO 
aA XXX 
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one wait-state memory access timing 


| 
| 
| 
CLKOUT2 7 


l | ft th(C2H-R) 


A15-A0,BR, 
PS,DS.R/W, 
OR iS 


| 
Pt thic2H-R) 
I td(C2H-R) onl me 'd(C2H-R)-=t ee : 
READY XXYXXXXY SERRE RXR REX KKK 
(X XXX XAXKX XX 


XXX XXX 


[ 
: lee t(M-R)-Y 7 | ia a 
D15-D0O | | th(M-R)—= | | d(M-R) 
(FOR READ 
OPERATION) 7 7 | : : | 
I | = | : 
I | 


D15-D0 TITIAN \) 

| OKA? OX 

iron wai BERRY be wy 
| 
| 


a KX | X XX ‘NZ XX f\ XXX f\ 


be th (M-R) 


as 
| 
! 


___ XKXKKR KKK KKK KKK KKK KKH COECOCECECETO OS 
MSC OQ OY RORY), 


‘ie te K—tdiMSC 
) 
——} be tamsc) 


43 
TEXAS 
INSTRUMENTS 


POST OFFICE BOX 1443 @ HOUSTON, TEXAS 77001 


A-21 


TMS320€25 
DIGITAL SIGNAL PROCESSOR 


RS, INT, BIO, and XF TIMING 


switching characteristics over recommended operating conditions (see Note 1) 


a onion oT ey 
an. ee 


NOTES: 1.Q = 1/4tg(c). 
6. RS, INT, and BIO are asynchronous inputs and can occur at any time during a clock cycle. However, if the specified setup 
time is met, the exact sequence shown in the timing diagrams will occur. 


timing requirements over recommended operating conditions (see Note 1) 


tsu(IN INT/BIO/RS setup before CLKOUT1 high 
thiIN INT/BIO/RS hold after CLKOUT1 high 


t#lIN INT/BIO fall time 
tw (IN) INT/BIO low pulse duration 
twiR RS low pulse duration 


NOTES: 1.Q = 1/4t,(¢). 
6. RS, INT, and BIO are asynchronous inputs and can occur at any time during a clock cycle. However, if the specified setup time 
is met, the exact sequence shown in the timing diagrams will occur. 


reset timing 


CLKOUT1 
1 


—tsu(iN) l 
thiIN) 


7 | 
- 2 a oe all 
AE RIAN POST IS SET IOY ETP PRY. o , 
A15-A0 ee rrtetrrtertrterertereaterrntrnter WA VALID XX 


| ees 
0°06 0'0'0 6°06 6046 6 606 6 0'4'6 06606 66 06 
D15-DO O55 2520292 92029 9 091 IY VALID Ee 
| 


CSCC COHCOEHOOS, 
PS QO OR KCK IK RRC | 


"0° 0°0'0' 0°00 066 0'O 0 000 66:00 0 606 6000 6 6, 
STRB QO II Oi ay 


BEGIN 
PROGRAM 
EXECUTION 


CONTROL SOOOCOOOL UU UO UU 
SIGNALST XXXXXXXXKKKKKK KKK KKK IIL 


YK YY 


OOOO OO OX) 
TACK QW ASSYYY), ESYSYY) 


SERIAL PORT OOOO) 


CONTROLS! XXXXXXRAEXKXKKRR KKK KK RRR KKK KY 


tControl signals are DS, 1S, R/W and XF. 
+Serial port controls are DX and FSX. 
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interrupt timing 


| 


STRB 
——  tsuin) | —-| k—th (IN) 
: twilN) | l 
iNT 2-INTO \ : i / 
es. | 
——1  F— tE(IN) | 
ta(IACK) == , 
— snc 


CRY Y 


x) AXXXY) es XX 


KY 


(NING 


BIO timing 


wm hf fh fy J Re: 

| 
| 
| 
| 
| 
| 
| 
| 


FETCH FETCH 
BRANCH ADDRESS NEXT INSTRUCTION 


A15-A0 


PC=N+1 


PC=N 
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external flag timing 
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HOLD TIMING 


switching characteristics over recommended operating conditions (see Note 1) 


Keng Orr; ~ ST 
ie SMEARGESS * 


ten(A-C1L) Address driven before CLKOUT1 low (HOLD mode, Note 3) 


NOTES: 1.Q = 1/4tg(c). 
3. A15-AO, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address.’’ 


timing requirements over recommended operating conditions (see Note 1) 


NOTE: 1.Q = 1/4tgic). 


HOLD timing (part A) 


CLKOUT1 


| 
| 
| 
| 


| 
N N+1 me Bas 
FETCH st 
EXECUTE <n en ee 


i 
a. ugk tdis(AL-A) 
HOLDA \ | 


| 

| 

! 
td(C1L-AL)-™" — 


ai 
TEXAS 
INSTRUMENTS 


POST OFFICE BOX 1443 @ HOUSTON, TEXAS 77001 


A-25 


TMS320C€25 
DIGITAL SIGNAL PROCESSOR 


ELLE SPE LAS AI SS ART I AES PTS TT PS LIE ME SEB ES, FRE SSIS PTE By SE LEE LN TSA EN PRR AS rl a Ne a 


HOLD timing (part B) 
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SERIAL PORT TIMING 


switching characteristics over recommended operating conditions (see Note 1) 


NOTES: 1.Q = 1/4tg(¢). 
7. The last occurrence of FSX falling and CLKX rising. 


timing requirements over recommended operating conditions (see Note 1) 


Ck Mar Ouariie. St. rns 
twiSck) Serial port clock (CLKX/CLKA) low pulse duration Gee Nowe) SS] OC 
tw(SCK) Serial port clock (CLKX/CLKR) high pulse duration (see Note 8) Ga a aaa 


tsu(FS) FSX/FSR setup time before (CLKX/CLKR) falling edge (TXM = O) 
th(FS) FSX/FSR hold time after (CLKX/CLKR) falling edge (TXM = 0) 
tsu(DR) DR setup time before CLKR falling edge 


th(DR) DR hold time after CLKR falling edge 


NOTES: 1.Q = 1/4tg(¢). 
8. The duty cycle of the serial port clock must be within 40-60%. 


serial port receive timing 
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serial port transmit timing 


p—-——tc(SCK) ——™ 


| 
tr(SCK) 
tw(SCK)—-—™4 es es . 


l 
thiFS) +=} tescKy—el ee Sidi! 
. belt (SCK) 


| 

| 

| 

FSX 
aput.txm-0) | /| bike [Pm taicHox) | , 

bee—tsu(FS) | | 

t 2 

| td(FL-DX) - ™=t~ 'd(CH-DX) 
—a! t z | 
Beleisds ay a td(CH-FS) 


FSX 
(OUTPUT,TXM = 1) 


TEXAS 
INSTRUMENTS 


POST OFFICE BOX 1443 @ HOUSTON, TEXAS 77001 


I 


A-27 


TMS320C€25 
DIGITAL SIGNAL PROCESSOR 


MECHANICAL DATA 


68-pin plastic leaded chip carrier package 


THERMAL RESISTANCE CHARACTERISTICS 


PARAMETER 


Junction-to-free-air 


R 
OJA thermal resistance 


R Junction-to-case 
dJC thermal resistance 


1,14 (0.045) X 45° 


4,78 (0.188) NOM 
ee sR 24,28 (0.956) 
1.14 (0,045) 24.1 
1,27 (0.050) X 45° OO8-10.028) 25.27 (0.995) 
_— 2,41 (0.095) MIN 24,59 (0.968 


[_SHHHMHW HHH ms 


gl 


~ 23,62 (0.930) 
23,32 (0.918) 


0,81 (0.032) 

0,66 (0.026) 
0,46 (0.018) 
0,36 (0.014) 


eHHHHHHHHHHHHHHHS 
--1— 1,52 (0.060) MIN ieee 0,25 (0.010) R 


3° NOM MAX 


3° NOM 


ALL LINEAR DIMENSIONS ARE IN MILLIMETERS AND PARENTHETICALLY IN INCHES 
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MARCH 1985—REVISED MAY 1986 


@ 200-ns Instruction Cycle Time @ Repeat Instructions for Efficient Use of 
@ 544 Words of Programmable On-Chip Data eragtant specs 
RAM @ Five Auxiliary Registers and Dedicated 
@. 128K Words of Data/Program Space Arithmetic Unit for Indirect Addressing 
@ Sixteen Input and Sixteen Output Channels Sorenh Parham oHeat Sone: Intertace 
© 16-Bit Parallel Interface Synchronization Input for Synchronous 
Multiprocessor Configurations 
e eratky Accessible External Data Memory Oi Mibeale: icicles ik ccenaastticia tins tokens 
aa Off-Chip Memories/Peripherals 
S 
Clone Pars Mencry interace On-Chip Timer for Control Operations 
STS arenes and Pate, mows Three External Maskable User Interrupts 
© Sent ey and Aecumulatay Input Pin Polled by Software Branch 
@ Single-Cycle Multiply/Accumulate Instruction 
instructions @ Programmable Output Pin for Signalling 
@® Oto 16-Bit Scaling Shifter External Devices 
Bit Manipulation and Logical Instructions 2.4-Micron NMOS Technology 
Instruction Set Support for Floating-Point Single 5-V Supply 
Operations On-Chip Clock Generator 
@ Block Moves for Data/Program Management 


PIN ASSIGNMENTS 


D3 
CLKOUT2 


SYNC 


FSX 
X2/CLKIN 


PIN FUNCTION; PIN  FUNCTION| PIN FUNCTION 68-PIN GB 
CLKOUT1 PS PIN GRID ARRAY CERAMIC PACKAGE! 
D4 (TOP VIEW) 


eer some. See ee ee * eat Ama eee oe ee 


rue & 2 «8: A. VAT) + eee 


T See Pin Assignments Table (Page 1) and Pin Nomenclature Table 


(Page 2) for location and description of all pins. 


=a 


Copyright © 1986, Texas Instruments Incorporated 


PRODUCTION DATA documents contain information 
current as of publication date. Products conform 
to specifications per the terms of Texas Instruments 
standard warranty. Production processing does not 
necessarily include testing of all parameters. 
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PIN NOMENCLATURE 


| NAME — | W/o/2t DEFINITION 


VCC 5-V supply pins 
VSs 
X1 
X2/CLKIN 
CLKOUT 1 
CLKOUT 2 
D15-DO 


Ground pins 


Output from internal oscillator for crystal 


Input to internal oscillator from crystal or external clock 
Master clock output (crystal or CLKIN frequency/4) 


A second clock output signal 

16-bit data bus D15 (MSB) through DO (LSB). Multiplexed between program, data, and |/O 
spaces. 

16-bit address bus A15 (MSB) through AO (LSB) 

Program, data, and |/O space select signals 


A15-AO 

PS,DS,IS 
R/W Read/write signal 

Strobe signal 

Reset input 

External user interrupt inputs 

Microstate complete signal 

Interrupt acknowledge signal 

Data ready input. Asserted by external logic when using slower devices to indicate that the 

current bus transaction is complete. 

Bus request signal. Asserted when the TMS32020 requires access to an external global data 


memory space. 


External flag output (latched software-programmable signal). 
Hold input. When asserted, TMS32020 goes into an idle mode and puts the data, address, and 
control lines in the high-impedance state. 

Hold acknowledge signal 

Clock synchronization input 

Branch control input. Polled by BIOZ instruction. 

Serial data receive input 

Clock for receive input for serial port 

Frame synchronization pulse for receive input 

Serial data transmit output 

Clock for transmit output for serial port 

Frame synchronization pulse for transmit. Configurable as either an input or an output. 


tV/0/Z = Input/Output/High-impedance state. 
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functional block diagram 
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description 


The TMS32020 Digital Signal Processor is the second member of the TMS320 family of VLSI digital signal 
processors and peripherals. The TMS320 family supports a wide range of digital signal processing 
applications, such as telecommunications, modems, image processing, speech processing, spectrum 
analysis, audio processing, digital filtering, high-speed control, graphics, and other computation-intensive 
applications. 


With a 200-ns instruction cycle time and an innovative memory configuration, the TMS32020 performs 
operations necessary for many real-time digital signal processing algorithms. Since most instructions require 
only one cycle, the TMS32020 is capable of executing five million instructions per second. On-chip data 
RAM of 544 16-bit words, direct addressing of up to 64K words of external data memory space and 64K 
words of external program memory space, and multiprocessor interface features for sharing global memory 
minimize unnecessary data transfers to take full advantage of the capabilities of the processor. 


architecture 


The TMS32020 architecture is based upon that of the TMS32010, the first member of the TMS320 family. 
The TMS32020 increases performance of DSP algorithms through innovative additions to the TMS320 
family architecture. TMS32010 source code is upward-compatible with TMS32020 source code and can 
be assembled using the TMS32020 Macro Assembler. 


Increased throughput on the TMS32020 for many DSP applications is accomplished by means of single- 
cycle multiply/accumulate instructions with a data move option, five auxiliary registers with a dedicated 
arithmetic unit, and faster |/O necessary for data-intensive signal processing. 


The architectural design of the TMS32020 emphasizes overall speed, communication, and flexibility in 
processor configuration. Control signals and instructions provide floating-point support, block-memory 
transfers, communication to slower off-chip devices, and multiprocessing implementations. 


Two large on-chip RAM blocks, configurable either as separate program and data spaces or as two 
contiguous data blocks, provide increased flexibility in system design. Maintaining program memory off- 
chip allows large address spaces from which large programs of up to 64K words can operate at full speed. 
Programs can also be downloaded from slow external memory to high-speed on-chip RAM. A total of 64K 
data memory address space is included to facilitate implementation of DSP algorithms. The VLSI 
implementation of the TMS32020 incorporates all of these features as well as many others, such as a 
hardware timer, serial port, and block data transfer capabilities. 


32-bit ALU/accumulator 


The TMS32020 32-bit Arithmetic Logic Unit (ALU) and accumulator perform a wide range of arithmetic 
and logical instructions, the majority of which execute in a single clock cycle. The ALU executes a variety 
of branch instructions dependent on the status of the ALU or a single bit in a word. These instructions 
provide the following capabilities: 


e Branch to an address specified by the accumulator 
e Normalize fixed-point numbers contained in the accumulator 
e Test a specified bit of a word in data memory. 


One input to the ALU is always provided from the accumulator, and the other input may be provided from 
the Product Register (PR) of the multiplier or the input scaling shifter which has fetched data from the 
RAM on the data bus. After the ALU has performed the arithmetic or logical operations, the result is stored 
in the accumulator. 


The 32-bit accumulator is split into two 16-bit segments for storage in data memory. Additional shifters 
at the output of the accumulator perform shifts while the data is being transferred to the data bus for 
storage. The contents of the accumulator remain unchanged. 
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scaling shifter 


The TMS32020 scaling shifter has a 16-bit input connected to the data bus and a 32-bit output connected 
to the ALU. The scaling shifter produces a left shift of O to 16 bits on the input data, as programmed 
in the instruction. The LSBs of the output are filled with zeroes, and the MSBs may be either filled with 
zeroes or sign-extended, depending upon the status programmed into the SXM (sign-extension mode) bit 
of status register STO. 


16 x 16-bit parallel multiplier 


The TMS32020 has a two’s complement 16 x 16-bit hardware multiplier, which is capable of computing 
a 32-bit product in a single machine cycle. The multiplier has the following two associated registers: 


e A 16-bit Temporary Register (TR) that holds one of the operands for the multiplier, and 
e A 32-bit Product Register (PR) that holds the product. 


Incorporated into the TMS32020 instruction set are single-cycle multiply/accumulate instructions that allow 
both operands to be processed simultaneously. The data for these operations resides in the on-chip RAM 
blocks and can be transferred to the multiplier each cycle via the program and data buses. 


Four product shift modes are available at the Product Register (PR) output that are useful when performing 
multiply/accumulate operations, fractional arithmetic, or justifying fractional products. 


timer 


The TMS32020 provides a memory-mapped 16-bit timer for control operations. The on-chip timer (TIM) 
register is a down counter that is continuously clocked by an internal clock. This clock is derived by dividing 
the CLKOUT1 frequency by 4. A timer interrupt (TINT) is generated every time the timer decrements to 
zero. The timer is reloaded with the value contained in the period (PRD) register within the same cycle 
that it reaches zero so that interrupts may be programmed to occur at regular intervals of 4 x (PRD) 
cycles of CLKOUT1. 


memory control 


The TMS32020 provides a total of 544 16-bit words of on-chip data RAM, divided into three separate 
blocks (BO, B1, and B2). Of the 544 words, 288 words (blocks B1 and B2) are always data memory, and 
256 words (block BO) are programmable as either data or program memory. A data memory size of 544 
words allows the TMS32020 to handle a data array of 512 words (256 words if on-chip RAM is used 
for program memory), while still leaving 32 locations for intermediate storage. When using block BO as 
program memory, instructions can be downloaded from external program memory into on-chip RAM and 
then executed. 


When using on-chip program RAM or high-speed external program memory, the TMS32020 runs at full 
speed without wait states. However, the READY line can be used to interface the TMS32020 to slower, 
less-expensive external memory. Downloading programs from slow off-chip memory to on-chip program 
RAM speeds processing while cutting system costs. 


The TMS32020 provides three separate address spaces for program memory, data memory, and I/O. The 
on-chip memory is mapped into either the 64K-word data memory or program memory space, depending 
upon the memory configuration. The CNFD (configure block BO as data memory) and CNFP (configure 
block BO as program memory) instructions allow dynamic configuration of the memory maps through 
software. Regardless of the configuration, the user may still execute from external program memory. 


The TMS32020 has six registers that are mapped into the data memory space: a serial port data receive 
register, serial port data transmit register, timer register, period register, interrupt mask register, and global 
memory allocation register. 
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(a) ADDRESS MAPS AFTER A CNFD INSTRUCTION 
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(b) ADDRESS MAPS AFTER A CNFP INSTRUCTION 


FIGURE 1. MEMORY MAPS 
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interrupts and subroutines 


The TMS32020 has three external maskable user interrupts INT 2-INTO, available for external devices that 
interrupt the processor. Internal interrupts are generated by the serial port (RINT and XINT), by the timer 
(TINT), and by the software interrupt (TRAP) instruction. Interrupts are prioritized with reset (RS) having 
the highest priority and the serial port transmit interrupt (XINT) having the lowest priority. All interrupt 
locations are on two-word boundaries so that branch instructions can be accommodated in those locations 
if desired. 


A built-in mechanism protects multicycle instructions from interrupts. If an interrupt occurs during a 
multicycle instruction, the interrupt is not processed until the instruction is completed. This mechanism 
applies both to instructions that are repeated or become multicycle due to the READY signal. 


external interface 


The TMS32020 supports a wide range of system interfacing requirements. Program, data, and I/O address 
spaces provide interface to memory and I/O, thus maximizing system throughput. I/O design is simplified 
by having I/O treated the same way as memory. I/O devices are mapped into the I/O address space using 
the processor’s external address and data busses in the same manner as memory-mapped devices. Interface 
to memory and |/O devices of varying speeds is accomplished by using the READY line. When transactions 
are made with slower devices, the TMS32020 processor waits until the other device completes its function 
and signals the processor via the READY line. Then, the TMS32020 continues execution. 


A serial port provides communication with serial devices, such as codecs, serial A/D converters, and other 
serial systems. The interface signals are compatible with codecs and many other serial devices with a 
minimum of external hardware. The serial port may also be used for intercommunication between processors 
in multiprocessing applications. 


The serial port has two memory-mapped registers: the data transmit register (DXR) and the data receive 
register (DRR). Both registers operate in either the byte mode or 16-bit word mode, and may be accessed 
in the same manner as any other data memory location. Each register has an external clock, a framing 
synchronization pulse, and associated shift registers. One method of multiprocessing may be implemented 
by programming one device to transmit while the others are in the receive mode. 


multiprocessing 


The flexibility of the TMS32020 allows configurations to satisfy a wide range of system requirements. 
The TMS32020 can be used as follows: 


e A standalone processor 

e A multiprocessor with devices in parallel 

e A slave/host multiprocessor with global memory space 

e A peripheral processor interfaced via processor-controlled signals to another device. 


For multiprocessing applications, the TMS32020 has the capability of allocating global data memory space 
and communicating with that space via the BR (bus request) and READY control signals. Global memory 
is data memory shared by more than one processor. Global data memory access must be arbitrated. The 
8-bit memory-mapped GREG (global memory allocation register) specifies part of the TMS32020’'s data 
memory as global external memory. The contents of the register determine the size of the global memory 
space. If the current instruction addresses an operand within that space, BR is asserted to request control 
of the bus. The length of the memory cycle is controlled by the READY line. 


The TMS32020 supports DMA (direct memory access) to its external program/data memory using the HOLD 
and HOLDA signals. Another processor can take complete control of the TMS32020’s external memory 
by asserting HOLD low. This causes the TMS32020 to place its address, data, and control lines in a 
high-impedance state and assert HOLDA. 
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instruction set 


The TMS32020 microprocessor implements a comprehensive instruction set that supports both numeric- 
intensive signal processing operations as well as general-purpose applications, such as multiprocessing 
and high-speed control. The TMS32010 source code is upward-compatible with TMS32020 source code. 


For maximum throughput, the next instruction is prefetched while the current one is being executed. Since 
the same data lines are used to communicate to external data/program or |/O space, the number of cycles 
may vary depending upon whether the next data operand fetch is from internal or external program memory. 
Highest throughput is achieved by maintaining data memory on-chip and using either internal or fast external 
program memory. 


addressing modes 


The TMS32020 instruction set provides three memory addressing modes: direct, indirect, and immediate 
addressing. 


Both direct and indirect addressing can be used to access data memory. In direct addressing, seven bits 
of the instruction word are concatenated with the nine bits of the data memory page pointer to form the 
16-bit data memory address. Indirect addressing accesses data memory through the five auxiliary registers. 
In immediate addressing, the data is based on a portion of the instruction word(s). 


In direct memory addressing, the instruction word contains the lower seven bits of the data memory address. 
This field is concatenated with the nine bits of the data memory page pointer to form the full 16-bit address. 
Thus, memory is paged in the direct addressing mode with a total of 512 pages, each page containing 
128 words. 


Five auxiliary registers (ARO-AR4) provide flexible and powerful indirect addressing. To select a specific 
auxiliary register, the Auxiliary Register Pointer (ARP) is loaded with either a O, 1, 2, 3, or a 4 for ARO 
through AR4, respectively. 


There are five types of indirect addressing: auto-increment or auto-decrement, post-indexing by either adding 
or subtracting the contents of ARO, or single indirect addressing with no increment or decrement. All 
operations are performed on the current auxiliary register in the same cycle as the original instruction, 
followed by a new ARP value being loaded. 


repeat feature 


A repeat feature, used with instructions such as multiply/accumulates, block moves, I/O transfers, and 
table read/writes, allows a single instruction to be performed up to 256 times. The repeat counter (RPTC) 
is loaded with either a data memory value (RPT instruction) or an immediate value (RPTK instruction). The 
value of this operand is one less than the number of times that the next instruction is executed. Those 
instructions that are normally multicycle are pipelined when using the repeat feature, and effectively become 
single-cycle instructions. 


instruction set summary 


Table 1 lists the symbols and abbreviations used in Table 2, the instruction set summary. Table 2 consists 
primarily of single-cycle, single-word instructions. Infrequently used branch, I/O, and CALL instructions 
are multicycle. The instruction set summary is arranged according to function and alphabetized within each 
functional grouping. The symbol (t) indicates those instructions that are not included in the TMS32010 
instruction set. 
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TABLE 1. INSTRUCTION SYMBOLS 


SYMBOL MEANING 


4-bit field specifying a bit code 

2-bit field specifying compare mode 

Data memory address field 

Format status bit 

Addressing mode bit 

Immediate operand field 

Port address (PAO through PA15 are predefined 


assembler symbols equal to 0 through 15, 
respectively.) 

2-bit field specifying P register output shift 
code | 

3-bit operand field specifying auxiliary register 
4-bit left-shift code 

3-bit accumulator left-shift field 
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TABLE 2. 


Absolute value of accumulator 
Add to accumulator with shift 
Add to high accumulator 

Add to low accumulator with 
sign extension suppressed 
Add to accumulator with shift 
specified by T register 

Add to accumulator 

long immediate with shift 
AND with accumulator 


AND immediate with accumulator with 


shift 
Complement accumulator 

Load accumulator with shift 

Load accumulator immediate short 
Load accumulator with shift 
specified by T register 

Load accumulator long 

immediate with shift 

Negate accumulator 

Normalize contents of accumulator 
OR with accumulator 

OR immediate with accumulator with 
shift 

Store high accumulator with shift 
Store low accumulator with shift 
Subtract from accumulator 

long immediate with shift 

Shift accumulator left 

Shift accumulator right 

Subtract from accumulator with shift 
Conditional subtract 

Subtract from high accumulator 
Subtract from low accumulator 

with sign extension suppressed 
Subtract from accumulator with 

shift specified by T register 
Exclusive-OR with accumulator 
Exclusive-OR immediate with 
accumulator with shift 

Zero accumulator 

Zero low accumulator and load high 
accumulator 

Zero accumulator and load low 
accumulator with sign extension 
suppressed 


INSTRUCTION SET SUMMARY 


ACCUMULATOR MEMORY REFERENCE INSTRUCTIONS 


Mnemonic Description ees | Instruction Bit Code 


-OoO--— 


—@ Oo Co 


=i o>) oo0o0-— 


1. Nes tell gana? oe. Sy o> 4; 3 - 2.4. 0 
| ee See 


4 
1 
0 
1 
1 


Ois.1 Ase OF. 0 DSO 1: 1 

0o-——s —— | —————_ D ———————— 
01000itst-—--—D——~> 
OPPO th ——— pb 


0) bei ee 4-0 


| ee 


ee Seen H. 0 0 -0i' 0. oO 1-0 


oo°co =) ogo oo io) © ooco 


1) eh re) er DD ere 
10 |) Oe, re 0 ree 
0. - eee See. OOO 8 a Te 49 
Bt ed 1 GAR Ce at es Cr ee a 
OG be Age 1 a te ee 1 Oe 4 
OSS ee errr See 
0001 1 141 ([——————D ——+> 
“000 1.600 k—_——D)-———+ 
2. O)°0--1..0 4) (ee 20 ere 
Po sG-0 -t:  o -ereeen 2 eeee 
O-O. Ft OOO » hts Di rete 
een areerrene Oe hee 8 
B256))-4_ 8: - eB 0 Oa os 0 -B.-- 0 
lame” SVS Ie 9 RS I accor a acerca © Re aeeecnae 
or: O- O° .@ 


Mnemonic Description 


AUXILIARY REGISTERS AND DATA PAGE POINTER INSTRUCTIONS 


Compare auxiliary register with 
auxiliary register ARO 
Load auxiliary register 


Load auxiliary register immediate short 


Load auxiliary register pointer 
Load data memory page pointer 
Load data memory page pointer 
immediate 


Load auxiliary register long immediate 


Modify auxiliary register 
Store auxiliary register 


mond o¢c oa 


LS a ee et. 


tThese instructions not included in the TMS32010 instruction set. 


Instruction Bit Code 


te: 7& TS5 fat WO Se oe 4S tk OO 


aes 3 Saas HE 0 O0<CM> 


ermnh nmwete (), ~ 9) = I OO = G 


| Scereenenegen) eee 
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TABLE 2. INSTRUCTION SET SUMMARY (CONTINUED) 


T REGISTER, P REGISTER, AND MULTIPLY INSTRUCTIONS 


Mnemonic aussi seis ae alacant: Instruction Bit Code 


to 14-33 32-41-40 3. 8 27-35 4 

Se oe P register to accumulator et. 3. OF 

LPHT Load high P register arr @ 4.9 

LT Load T register o;6:. 4% 4 

LTA Load T register and accumulate Or’ tig 
previous product 

LTD Load T register, accumulate previous Oro 4 1 #7 
product, and move data 

LTPt Load T register and store P 070-7 1. 1 17. Lore 
register in accumulator 

LTSt Load T register and subtract o;t © 3. i--8.-t- 4 
previous product 

MACt = Multiply and accumulate S740 - Becks 

MACDt Multiply and accumulate Ost © - 1h hated 
with data move 

MPY Multiply (with T register, store product 0 1 t 1.9 2.39 


in P register) 
MPYK Multiply immediate 
PAC Load accumulator with P register 
SPAC Subtract P register from accumulator 
SPMt Set P register output shift mode 
Square and accumulate 
Square and subtract previous product 


ee eee ee ee | Senne emer | TO GRANCH/GALL INGTRUCTIONS = «—-_ (RET Ser Bore: FE Tee’ 


Mnemonic Description Instruction Bit Code 


| 


Ses ei as EE 
Branch unconditionally 5 anes SE Rs (———— 9 
ace Branch to address specified by +~--}¥-- 9 --9 5 O--9---4-.-0--G--7 -8 1 
accumulator 
BANZ Branch on auxiliary register not zero 2 ps Rs OS OS © DO OS a 
BBNZt Branch if TC bit # 0 2 1 1 1 1 1 QQ I ——— De 
BB2Zt Branch if TC bit = 0 2 | es es Pn Pe © @ ee 0 Be Ds 
BGEZ Branch if accumulator >0 2 1 1 1 1 0 4 QQ 1 nD 
BGZ Branch if accumulator > 0 z 1 PF 1 QQ QQ DD ee De 
BIOZ Branch on 1/O status = 0 Z 1 $174 14 14 0 1 QO 1 <————— DD 
BLEZ Branch if accumulator < 0 2 1 1 1 41 QO QO FQ I De 
BLZ Branch if accumulator < 0 2 y es i I © OE © IS UN OO ED 
BNVt Branch if no overflow 2 yes Ps I I © OS I OS OO ed 
BNZ Branch if accumulator # 0 2 pees es (Os © UU © UU I 9 
BV Branch on overflow 2 11914 10 0 00010 —_—_—_—E_E_—_—_ D0 —_—_—_—_—>—>—>>—> 
BZ Branch if accumulator = 0 2 1°41 4 #1 0 4 1 0 1 sere Oe 
CALA Call subroutine indirect 1 7) 2. 0 - 1-4: 1. 8 @.4 Seo FB ie 
Call subroutine 2 ys Rs OS OO 
Return from subroutine 1 +--+ 8 0-1 -+1---+4+---§ 8 ~ 6 4-8 6-2 


TThese instructions not included in the TMS32010 instruction set. 
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TABLE 2. INSTRUCTION SET SUMMARY (CONCLUDED) 
CONTROL INSTRUCTIONS 


Mnemonic Description ce Instruction Bit Code 


Test bit 

Test bit specified by T register 
Configure block as data memory 
Configure block as program memory 
Disable interrupt 

Enable interrupt 

Idle until interrupt 

Load status register STO 

Load status register ST1 

No operation 

Pop top of stack to low accumulator 
Pop top of stack to data memory 
Push data memory value onto stack 
Push low accumulator onto stack 
Reset overflow mode 

Repeat instruction as specified 

by data memory value 

Repeat instruction as specified 

by immediate value 

Reset sign-extension mode 

Set overflow mode 

Store status register STO 

Store status register ST1 

Set sign-extension mode 

Software interrupt 


= 
on 
a 


a 


—_= SS RS SV eS et ee et tS =| CO] LH 
—_ 


ah att at ah att ot ot oot od ot ot ot ot ot ot ot 
o=---" Ooo" ooo} - = = ' -  O 
_—2 = O— = OdOd - - | = Oo 
_==—-| =| O-" Oddo 
="OQo000- " Ooodo00d0o =~ 


o o- 


— 
—s 
—", 
—_ 
—, 


OO = 0 Oo oO Com O38 0 a] Oa oO = 
—> 


—~2sO0—— 
oo-OoO°0O 0° 


1 
1 
0 
0 
1 
1 


1 
1/0 AND DATA MEMORY OPERATIONS 


No. 
Mnemonic Description Instruction Bit Code 


aeamenee RS! ead ORT KER @ wus > 


Block move from data memory to ss me ey oes eg a 2 Sg 
data memory 

Block move from program memory 
to data memory 

Data move in data memory 

Format serial port registers 

Input data from port 


PP 2 ee th 


Output data to port 

Reset serial port transmit mode 
Reset external flag 

Set serial port transmit mode 
Set external flag 

Table read 

Table write 


_= St et ow os = O—- — 
ee kokokoko er Fe eke) 
—==- Oo ocoo0odoo= 


0 
1 
1 
1 
1 
1 
1 
1 
0 
0 


tThese instructions not included in the TMS32010 instruction set. 
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development systems and software support 


Texas Instruments offers concentrated development support and complete documentation for designing 
a TMS32020-based microprocessor system. When developing an application, tools are provided to evaluate 
the performance of the processor, to develop the algorithm implementation, and to fully integrate the 
design’s software and hardware modules. When questions arise, additional support can be obtained by 
calling the nearest Texas Instruments Regional Technology Center (RTC). 


Sophisticated development operations are performed with the TMS32020 Macro Assembler/Linker, 
Simulator, and Emulator (XDS). The macro assembler and linker are used to translate program modules 
into object code and link them together. This puts the program modules into a form which can be loaded 
into the TMS32020 Simulator or Emulator. The simulator provides a quick means for initially debugging 
TMS32020 software while the emulator provides the real-time in-circuit emulation necessary to perform 
system level debug efficiently. 


Table 3 gives a complete list of TMS32020 software and hardware development tools. 


TABLE 3. TMS32020 SOFTWARE AND HARDWARE SUPPORT 


MACRO ASSEMBLERS/LINKERS 
Operating System 
DEC VAX TMDS3241210-08 


MS/PC-DOS 
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absolute maximum ratings over specified temperature range (unless otherwise noted)! 


Supply voltage-range; Vee? .s63 Los titiaes ocavcbhlsash bohaiimeccs angie 21aee -0.3Vto7V 
Minhit: pega Penge: 35 Sotsccie. a Oe Baad oS con bes va eee uc Deed aH ¥ te 7-V 
Cistet VOROUG: TANGS .fiGlioiasiieii cores Es ask QS ieee oe .2Ge8 Ow, e8t. ta O38 siovite 7 V 
GCentinsious mowercliesination: i.¢ 4:6 Geihies. 8 cee eek wo tee be Oravoids ee 2.0 W 
Operating free-air temperatura range >. ga6koed2-. |. aoa. 4 ecw eo. ae rs EE eaigen.. O° Gta: 70°C 
ene enn CIPD TUR SE Oe INT a fhe BS Fics oie es he Wee eek be sie a mek to 150°C 


tStresses beyond those listed under ‘‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating 
only and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions’ section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. 

+All voltage values are with respect to Vss. 


recommended operating conditions 


Vor Supply voltage 4.75 5 5.25 
Vss__ Supply voltage oo 
3 


All inputs except CLKIN 
vig curate! 'iabut voltage cc+os | Vv 
CLKIN 2.4 “ros, vO 
IL , 


V 

| V 

se ce 

All inputs except CLKIN -0.3 0.8 V 
V idldiei Geli vohoas a ae 
CLKIN -0:3 0.8 


IOH High-level output current pA 
ioL Low-level output current 
TA Operating free-air temperature (Notes 1 and 2) 


NOTES: 1. Case temperature (TC) must be maintained below 90°C. 
2. Raja = 36°C/Watt; Rejc =6°C/Watt. 


electrical characteristics over specified free-air temperature range (unless otherwise noted) 


PARAMETER TEST CONDITIONS MIN TYP’ MAX | UNIT 
VOH High-level output voltage Vcc = MIN, Ioq = MAX 
VOL 


Low-level output voltage Vcc = MIN, lot = MAX 0.3 0.6 
IZ Three-state current Vcc = MAX ~ 20 20 


Ta = 0°C, Vcc = MAX, fy = MAX 
Ta = 25°C, Vcc = 5V, fy = MAX 250 
Se RN Me 1 | LY SS | || | Se Eee | aad 
ie OR 1 a ee Sei eae 


TAIl typical values are at Vcc = 5 V, Ta = 25°C. 


y 


dy ~ Caution. This device contains circuits to protect its inputs and outputs against damage due to high static voltages or electrostatic 

fields. These circuits have been qualified to protect this device against electrostatic discharges (ESD) of up to 2 kV according 

to MIL-STD-883C, Method 3015; however, it is advised that precautions be taken to avoid application of any voltage higher than maximum 

rated voltages to these high-impedance circuits. During storage or handling, the device leads should be shorted together or the device 

should be placed in conductive foam. In a circuit, unused inputs should always be connected to an appropriate logic voltage level, preferrably 

either Vcc or ground. Specific guidelines for handling devices of this type are contained in the publication ‘‘Guidelines for Handling Electrostatic- 
Discharge Sensitive (ESDS) Devices and Assemblies’’ available from Texas Instruments. 


Supply current 
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CLOCK CHARACTERISTICS AND TIMING 


The TMS32020 can use either its internal oscillator or an external frequency source for a clock. 
internal clock option 


The internal oscillator is enabled by connecting a crystal across X1 and X2/CLKIN (see Figure 2). The 
frequency of CLKOUT1 is one-fourth the crystal fundamental frequency. The crystal should be fundamental 
mode, and parallel resonant, with an effective series resistance of 30 ohms, a power dissipation of 1 mW, 
and be specified at a load capacitance of 20 pF. 


PARAMETER TEST CONDITIONS MIN TYP MAX | UNIT 
fx 


Input clock frequency Ta = 0°C to 70°C 6.7 20.5 | MHz | 
fsx Serial port frequency Ta = O°C te 70°C SS ae ae 
C1, 2 Ta = 0°C t0 70°C oe Aes ee 


: ANE : 
au se 


FIGURE 2. INTERNAL CLOCK OPTION 


external clock option 


An external frequency source can be used by injecting the frequency directly into X2/CLKIN with X11 left 
unconnected. The external frequency injected must conform to the specifications listed in the following table. 


switching characteristics over recommended operating conditions (see Note 3) 


td(CIH-C)  CLKIN high to CLKOUT 1/CLKOUT 2/STRB high/iow 
t#(C) CLKOUT1/CLKOUT2/STRB fall time 


CLKOUT 1/CLKOUT 2/STRB rise time 
twiCL) CLKOUT1/CLKOUT2 low pulse duration 


tw(CH) CLKOUT1/CLKOUT2 high pulse duration 20-15 2Q 20+15 


NOTE 3: Q = 1/4tgic). 
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timing requirements over recommended operating conditions (see Note 3) 


tc(Cl) CLKIN cycle time 
tf(Cl) CLKIN fall time 
triCl) CLKIN rise time 


tw(CIL) CLKIN low pulse duration, tc(cj) = 50 ns (Note 4) 
twi(CIH) CLKIN high pulse duration, tc(c}) = 50 ns (Note 4) 
tsu(S) SYNC setup time before CLKIN low 

thiS) SYNC hold time from CLKIN low 


NOTES: 3. Q = 1/4tgic). 
4. CLKIN duty cycle [tr(c}) + tw(CIH)]/te(c}) Must be within 40-60%. 


2.15 V 


Rp = 82520 


FROM OUTPUT 
UNDER TEST TEST 
POINT 


7 Ci = 100 pF 


FIGURE 3. TEST LOAD CIRCUIT 


=== =——— Vin (MIN) 


SS SS Se Vit (MAX) 


(a) INPUT 


— ——— Von (MIN) 


——_— —_— Voi (MAX) 


(b) OUTPUTS 


FIGURE 4. VOLTAGE REFERENCE LEVELS 
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clock timing 


fe feicn— 


X2/CLKIN 


ee | feet taicin-c) | tc(C) | 
CLKOUT2 tw(CH) twiCL)—— 
taic1-c2) j-———+}- tgic1-c2) FIC) tr(C) her 


| | feel —t4(01-c2) 
lee] — ta(¢1-c2) 
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MEMORY AND PERIPHERAL INTERFACE TIMING 


switching characteristics over recommended operating conditions (see Note 3) 


[tei1.5)__ STB from CLKOUTI PETA is present) ——S~—S—S~S~— vt |e 
taic2-s)  CLKOUT2 to STRE it STAB is present) ~SSSC~C‘“‘*~*~*‘“‘“‘“dCSCN SSC te 
tata) Address sotup time before STRB ow Note 6) ——~S~S~s=WSSS~dC 
th(A) Address hold time after STRB high (Note 5) S preawerae eis 
tw(SL) STRB low pulse duration (no wait states, Note 6) Ma we ae EG 
tw(SH) STRB high pulse duration (between consecutive cycles, Note 6) eee: Se Ee ee 

| ons 

outa 

pata 2 

eve 

ead 


tsu(D)W Data write setup time before STRB high (no wait states) 
th(D)W Data write hold time from STRB high Ta ae 
ten(D) Data bus starts being driven after STRB low (write cycle) Ss: aes Ba 


NOTES: 3. Q = 1/4t.(¢). 
5. A15-A0, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address."’ 
6. Delays between CLKOUT 1/CLKOUT 2 edges and STRB edges track each other, resulting in tw(SL) and tw (SH) being 20 with no 
wait states. 


timing requirements over recommended operating conditions (see Note 3) 


ta(A) Read data access time from address time (read cycle, Notes 5 and 7) 30-70 
tsu(D)R Data read setup time before STRB high i Seeses 
thiD)R Data read hold time from STRB high a eas 


td(SL-R) READY valid after STRB low (no wait states) 


READY hold time after MSC valid 


th(M-R 


NOTES: 3. Q = 1/4tgc). 
5. A15-A0, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address.”’ 
7. Read data access time is defined as taj) = tsu(A) + tw(SL) — tsu(D)R:- 


TEXAS 4% ; 
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memory read timing 


#————+- td(C1-S) 
| 
CLKOUT1 ! . 
| 
| 
| aormeran ti (2 td(C1-S) 


CLKOUT2 | 


K- ta(C2-S) 


'AAAAAAAAAAAAAAAAAAAAAAAAPPAAAPAARAA 


AUOOOOOOOCCECOOCOOOOORO OOO OOOOO ODES 


OOOOH OOOO OOOO OOO OOOO OS | | 


ZABABAAAAALAAAAAAAAAAABLAAAAA LAL 


| x 
t “ ew 


D15-D0 oar A 


memory write timing 


CLKOUT1 


CLKOUT2 


PDPADAAAAAA 


190400008 


6 
Ceretetate ates 


OOOO OOOO OK NOOO IKK KIKI KKK IK ORO OX 
() OXXXXKXX) (x) 
Sa III) 


READY 


RRA RARER 


RRREKRRN 
090000008 

. 
OO 


-~eehenee 


D15-D0 


1 | k— tdis(D) 4 


j 
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one wait-state memory access timing 


B-20 


CLKOUT1 
| | 
| 1 
CLKOUT2 | | ! ) 
| | | | 
| ! | | 
STRB | | | | 
| 
| | | t 
! h(C2H-R) 
A15-A0,BR, rm 
PS,DS,R/W, 
OR IS 
k——+t+-+ th(C2H-R) | 
td(C2H-R) +e | td(C2H-R) | 
OO AAA AA ee -000000000060000606000000000000000008 
RE ADY BYXX XK RX KKK RAK RK EKER KARA XN RY WOOK KK KX KX AX AX KEKE KX KX 
RAI KK IKK ) 0.6.0.0.6.940060000000000000000000008 
' 
td(M-R) +» ! : td(M-R) -le ! a th(M-R) 
' 
D15-D0O | | —> + th(M-R) | eS |f DATA 
(FOR READ } | | | | | IN 
OPERATION) | ee | 
\ | es | | 
D 1 5-DO | ERIE RTE | 
(FOR WRITE DATA OUT ; 
OPERATION) l | =~ _ 
i | | | | 
l | 
“o'0'0'0'0' 0066: Un ar 6666660000000 0060000006 “COOOCCOOOOOO OOOO OOOO OOOO O OOO 
——— POOOOOOOOOEOO OOOO ROO COORG 
MSC BODO OOOROOOOO IK I 


COOOOOOOOHOF OO OOOO OOO OOOO COED 


ee ek ee ek ee ke ee ee ee ee ee 


OE tC OOOO aaa 


+ & taimsc) | 


ar — td(MSC) 
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RS, INT, BIO, and XF TIMING 


switching characteristics over recommended operating conditions (see Note 3) 


Tens CLOUT ow tose eeamneed a 


NOTE 3: Q = 1/4tgic). 
8. RS, INT, and BIO are asynchronous inputs and can occur at any time during a clock cycle. However, if the specified setup 
time is met, the exact sequence shown in the timing diagrams will occur. 


timing requirements over recommended operating conditions (see Note 3) 


tsu(IN) INT/BIO/RS setup before CLKOUT1 high 
thi(IN) INT/BIO/RS hold after CLKOUT1 high 


tf(IN) INT/BIO fall time 
tw (IN) INT/BIO low pulse duration 


twiRS RS low pulse duration 


NOTE 3: Q = 1/4tgc). 
8. RS, INT, and BIO are asynchronous inputs and can occur at any time during a clock cycle. However, if the specified setup time 
is met, the exact sequence shown in the timing diagrams will occur. 


reset timing 


CLKOUT1 , | 
—tsu(IN) 
7 | thiiN) 
. a ee 
96°00, 0000004, 0'070,0,0,0'0,0'0'0'06, 0508, 0°056 Q) ( 
A15-A0 IRON, AX VALID XX 


: | peu 
OOOO OOOO OOOO OOOO OOOO OOOO 
D15:-D0 RRR ee RRR EARN ae) 
| 
| 


PS KKK KK KKK KKK KKK KY | 
| 
| 


LOCATION 0 


BEGIN 
PROGRAM 


RW KN EXECUTION 


STRB SLXKXXXKXXKKKK KK KARL KKRKAKKKLAY | 


CONTROL XXXXX KX OOOO OOOO OOOO OOO OOOO OC CY 
SIGNALS t RRR RRR KR KKK IY 


XXX XXX XY 
YQUYY 


ACK QO, EY, 


SERIAL PORT XXXQQQOQOOOQOOO OOOO A AAAAAAAK AK 
CONTROLS! XXXXRKXXXXKKKXKKKXKX KK XK KKK KKY 


Control signals are DS, IS, R/W and XF. 
+ Serial port controls are DX and FSX. 
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interrupt timing 


CLKOUT1 7 | 


STRB 
ae t 
INT2-INTO \ a | Y 
I | | es 
pl ie HIN) | = 


A15-A0 FETCH N FETCH N+1 FETCH | FETCH 1+1 


ee 8 ee © ee 8: ee ee we ee ee oe ee. 2 2 2 oe ee + ee te ee ee ee 


5600000600 0008 
seoeeeoeoeere? 


ooeee? 4 ’ ‘ 

¢eeeeeee 

IACK BOOOOOOOOU IG ’ BOO OG 
AAA NAY | SOOO OCY x 1k BOO OOK Xi 


ta(lACk) — ¢— —> © tqiack) 


BIO timing 
) 
STAB | 
FETCH FETCH 
BRANCH ADDRESS | NEXT INSTRUCTION 
A15-A0 
PC=N PC =N+1 i 
ee] 
tsu(IN) 2a a PC=N+2 
| 
BIO 
% 
— TEXAS 
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external flag timing 


>| le— td(XF) 
| I 
A15-A0 i SXF/RXF i VALID ¢ VALID 
PC =N PC=N+1 | PC=N+2 
| 
! 
OOO UU UU UU UU UO UU UUQOOOOOO OOK) 


XANAX ARAN PRXXERAXARAY AXA ERR ERRKXXRRKX RAK ERAN EH 
YXXXXXXXXXXK XXX XXX KK KXXKKKXXKKKAK KKK EK KYY YY KKK YLY 


XF 
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HOLD TIMING 


switching characteristics over recommended operating conditions (see Note 3) 


nee SS Son ee 
ee ee a ag 
dati) Addons tree state gfe CLRDUT! ow OTD note, Now | | ee 
ee 
Baas Verne 


td(HH-AH) HOLD high to HOLDA high 
ten(A-C1L) Address driven before CLKOUT1 low (HOLD mode, Note 5) 


NOTES: 3. Q = 1/4tgc). 
5. A15-A0, BS BS, iS, R/W, and BR timings are all included in timings referenced as ‘‘address."’ 


timing requirements over recommended operating conditions (see Note 3) 


td(C2H-H) HOLD valid after CLKOUT2 high Pe a 


NOTE: 3. Q = 1/4tgc). 


HOLD timing (part A) 


! 
ad | 
STRB | 
l 


—p j¢— td(C2H-H) | 
HOLD 


A15-A0 


R/W =—— 
—>  @— tdis(C1L-A) 
D15-D0 


| 
N N+1 N/A | 
| 


FETCH 


N—1 N DUMMY 
EXECUTE 
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HOLD timing (part B) 


CLKOUT1 
= 
CLKOUT2 : 4 
| | 
a | tity 
STRB | el 
—» = le taic2H-H) | | 
HOLD 
A15-A0 
PS,DS, 
OR IS 
R/W 
| 
| 
015.00 (n) (") 
| 
: 
a N/A N/A N+2 N+3 
g ————->—_e——_ 
| 
DEAD DEAD N+1 N+2 
EXECUTE p ena icie SORES” > eee (See | ee | arte 


HOLDA al | Se td(HH-AH) 
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SERIAL PORT TIMING 


switching characteristics over recommended operating conditions (see Note 3) 


PARAMETER MIN TYP MAX UNIT 


td(CH-DX) OX valid after CLKX rising edge (Note 9) ieee eae Be a 
td(FL-DX) DX valid after FSX falling edge (TXM = O, Note-9) ae ce ee ee 
td(CH-FS) FSX valid after CLKX rising edge (TXM = 1) eee Fae 


NOTES: 3. Q = 1/4tgi¢). 
9. The last occurrence of FSX falling and CLKX rising. 


timing requirements over recommended operating conditions (see Note 3) 


te(SCK) Serial port clock (CLKX/CLKR) cycle time 390 20,000 | ns _ | 
tf(SCK) _ Serial port clock (CLKX/CLKR) fall time st Se 


Ttrscx) Serie! port clock (CLKXICLKR) rise time CY SCC=*S 
150 12,000 | ns 
Tteu(es) _FSXIFSR setup time before (CLKXICLKR) faling edge (TXM= 0) ——*‘|—20-~SSS~dC 
= 0) 


0 
th(FS) FSX/FSR hold time after (CLKX/CLKR) falling edge (TXM 
tsu(DR) DR setup time before CLKR falling edge 20 


th(DR DR hold time after CLKR falling edge 


NOTES: 3. Q = 1/4tgic). 
10. The duty cycle of the serial port clock must be within 40-60%. 


serial port receive timing 


l¢—— tc(SCK) —> 
| «> tw(SCK) 
| 


tr(SCK) + - | 


CLKR 


serial port transmit timing 


¢—— tc(SCK) —> 


twiSCK) > o> a: tase 


; ; t#(SCK) > + ie 


! 
th(FS) -~»! ¢ i¢—____»+ tw(SCK) 
FSX 


(INPUT, TXM = 0) 


| @—p td(CH-DX) | 
ta(FL-DX) 4¢* '¢— *d(CH-DX) 


i 
+> + tsu(FS) | 
\ >! qt 9 
i taonpey | [eee 
FSX ! 
(OUTPUT, TXM = 1) ! 
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MECHANICAL DATA 
68-pin GB pin grid array ceramic package 


TOP VIEW 


28,448 (1.120) 
27,432 (1.080) 


17,02 (0.670) 


cg NOM 


THERMAL RESISTANCE CHARACTERISTICS 


28,448 (1.120) 
27,432 (1.080) 


17,02 (0.670) 
NOM 


4,953 (0.195) 
2,032 (0.080) 1,397 (0.055) 
MAX 
| 
3,302 (0.130) 0,508 (0.020) UT reson DIA 
2.794 (0.110) 0,406 poe 1,473 (0.058) 
Pe oho BOTTOM VIEW 


1,524 (0.060) 
NOM 


OOO GOOOOOOO®O/ | «riaces 
©©©OOOOOS—|+ 


123 4 5 6 7 8 9 1011 £1.27(0.050) 
NOM 


ALL LINEAR DIMENSIONS ARE IN MILLIMETERS AND PARENTHETICALLY IN INCHES 
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ADVANCE TMS320C€10 
INFORMATION DIGITAL SIGNAL PROCESSOR 


JANUARY 1986 


DIO LJ13 28L}A10 
Eight Input and Eight Output Channels DELS Tet 278 a1 
D12{415 261}{D0 
DI3 E116: 2583 D1 
D14[]17 247) v2 
Interrupt with Full Context Save D15[J18 23f])D3 


Signed Two’s-Complement Fixed-Point D7 [J19 227) D4 
Arithmetic p06 l20 2111D5 


@® 200-ns Instruction Cycle N PACKAGE 
@ 144-Word On-Chip Data RAM (TOP VIEW) 
ed 
® ROMless Version — TMS320C10 A1/PA1 L} 1 “40, J A2/PA2 
AO/PAOL]2 391) A3 
@ 1.5K-Word On-Chip Program ROM — MC/MP [13 38L]A4 
TMS320CM10 RSfla 37flas 
@® External Memory Expansion to a Total of 4K INT : 5 ii A6 
Words at Full Speed CLKOUT L]6 A7 
X1L)7 34LJ] A8 
@® 16-Bit Instruction/Data Word X2/CLKIN 18 331] MEN 
@® 32-Bit ALU/Accumulator BIOLjs 32,1 DEN 
Vssg LJ10 31L] WE 
@ 16x 16-Bit Multiply in 200 ns pb8(111 30f] Vcc 
@ Oto 16-Bit Barrel Shifter D9LJ12 291] A9 
® 
& 


16-Bit Bidirectional Data Bus with 
40-Megabits-per-Second Transfer Rate 


CMOS Technology 
Single 5-V Supply 


description 
The TMS320C10 is the first low-power CMOS pence 
member of the Texas Instruments TMS320 en 
family of Digital Signal Processors. This device = i es 
is a CMOS pin-for-pin compatible version of the E In 2 S O 5) 2 st 12.49 
industry-standard TMS32010 Digital Signal = pp nr en enn 
Processor. The 100-mW typical power 65 4 
dissipation of the TMS320C10 enables power- CLKOUT |j7 39[] A7 
sensitive applications to take advantage of the X18 38] A8 
TMS32010’s high performance. The 16/32-bit X2/CLKIN [9 37 [] MEN 
microcomputer was designed to support a wide BIO |} 10 361] DEN 
range of high-speed and numeric-intensive NC [11 351] WE 
applications. The TMS320C10 combines the Vss 12 34 Vcc 
flexibility of a high-speed controller with the D8 }J13 334 AQ 
numerical capability of an array processor, D9}J14 32[] A10 
thereby offering an inexpensive alternative to D10)15 31U) A11 
multichip bit-slice processors. The highly D11}J16 30[| DO 
pipelined architecture and efficient instruction D121)17 291} D1 
set of the TMS320C10 provides the capability sis joc iadg et tk abd Sie Set hes Seu eet 
of executing more than five million instructions = ore ee ot ae ee 2 
per second. The instruction set is easily Qa 0 


programmed and contains general-purpose as 
well as digital signal processing instructions. 


ADVANCE INFORMATION documents contain ~ Copyright © 1986, Texas Instruments Incorporated 
information on new products in the sampling or wis 

be ei gr gamed ee TEXAS e.1 
ata and other specifications are subject to change F 
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PIN NOMENCLATURE 


DEFINITION 


A11-A0/PA2-PAO External address bus. I/O port address multiplexed over PA2-PAO. 


BIO 


External polling input for bit test and jump operations. 


CLKOUT System clock output, % crystal/CLKIN frequency. 
D15-DO 16-bit data bus. 
DEN Data enable indicates the processor accepting input data on D15-D0O. 


INT 


Interrupt. 

Memory mode select pin. High selects microcomputer mode. Low selects microprocessor 
mode. 

Memory enable indicates that D15-DO will accept external memory instruction. 

No connection. 

Reset used to initialize the device. 

Power. 


Vss Ground. 


WE 
X1 


Write enable indicates valid data on D15-D0O. 
Crystal input. 


X2/CLKIN Crystal input or external clock input. 


The TMS320 family’s unique versatility and power give the design engineer a new approach to a variety 
of complex applications. In addition, these microcomputers are capable of providing the multiple functions 
often required for a single application. For example, the TMS320 family can enable an industrial robot to 
synthesize and recognize speech, sense objects with radar or optical intelligence, and perform mechanical 
operations through digital servo-loop computations. 


architecture 


The TMS320 family utilizes a modified Harvard architecture for speed and flexibility. In a strict Harvard 
architecture, program and data memory lie in two separate spaces, permitting a full overlap of the instruction 
fetch and execution. The TMS320 family’s modification of the Harvard architecture allows transfers 
between program and data spaces, thereby increasing the flexibility of the device. This modification permits 
coefficients stored in program memory to be read into the RAM, eliminating the need for a separate 
coefficient ROM. It also makes available immediate instructions and subroutines based on computed values. 


The TMS320C10 utilizes hardware to implement functions that other processors typically perform in 
software. For example, this device contains a hardware multiplier to perform a multiplication in a single 
200-ns cycle. There is also a hardware barrel shifter for shifting data on its way into the ALU. Finally, 
extra hardware has been included so that auxiliary registers, which provide indirect data RAM addresses, 
can be configured in an autoincrement/decrement mode for single-cycle manipulation of data tables. This 
hardware-intensive approach gives the design engineer the type of power previously unavailable on a single 
chip. 


32-bit ALU/accumulator 


The TMS320C10 contains a 32-bit ALU and accumulator that support double-precision arithmetic. The 
ALU operates on 16-bit words taken from the data RAM or derived from immediate instructions. Besides 
the usual arithmetic instructions, the ALU can perform Boolean operations, providing the bit manipulation 
ability required of a high-speed controller. 
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functional block diagram 


X1 
CLKOUT X2/CLKIN 


WE 
BEN « \ MUX | 
MEN | 
_ 2 
a a PC (12) INSTRUCTION 
MC/MP 5 
iris © 
INT ” 
ad ” | PROGRAM 
RS a ROM 
5 | (1536 x 16) 
q 
A11-A0/ 
PA2-PAO 


16 


D15-D0 


rae ARO (16) | T(16) e 
SHIFTER MULTIPLIER 


(0-15) 

DATA RAM 

(144 x 16) 
LEGEND: 
ACC= Accumulator 
ARP = Auxiliary register pointer 
ARO= Auxiliary register O |. Acca. | 
AR1= Auxiliary register 1 
DP = Data page pointer 
PC = Program counter 
P = P register 
T = T register 

DATA BUS 
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shifters 


A barrel shifter is available for left-shifting data O to 15 places before it is loaded into, subtracted from, 
or added to the accumulator. This shifter extends the high-order bit of the data word and zero-fills the 
low-order bits for two’s-complement arithmetic. A second shifter left-shifts the upper half of the accumulator 
O, 1, or 4 places while it is being stored in the data RAM. Both shifters are useful for scaling and bit 
extraction. 


16 x 16-bit parallel multiplier 


The TMS320C10’s multiplier performs a 16 x 16-bit, two’s-complement multiplication in one 200-ns 
instruction cycle. The 16-bit T Register temporarily stores the multiplicand; the P Register stores the 32-bit 
result. Multiplier values either come from the data memory or are derived immediately from the MPYK 
(multiply immediate) instruction word. The fast on-chip multiplier allows the TMS320C10 to perform such 
fundamental operations as convolution, correlation, and filtering at the rate of better than 3 million samples 
per second. 


program memory expansion 


The TMS320CM10 is equipped with a 1536-word ROM, which is mask-programmed at the factory with 
a customer’s program. It can also execute from an additional 2560 words of off-chip program memory 
at full speed. This memory expansion capability is especially useful for those situations where a customer 
has a number of different applications that share the same subroutines. In this case, the common subroutines 
can be stored on-chip while the application specific code is stored off-chip. 


The TMS320CM10 can operate in either of the following memory modes via the MC/MP pin: 


Microcomputer Mode (MC) — Instruction addresses O-1.535 fetched from on-chip ROM; instruction 
addresses 1536-4095 fetched from off-chip memory at full speed. 


Microprocessor Mode (MP) — Full-speed execution from all 4096 off-chip instruction addresses. 


The TMS320C10 is identical to the TMS320CM10, except that the TMS320C10 operates only in the 
microprocessor mode. Henceforth, TMS320C10 refers to both versions. 


The ability of the TMS320C10 to execute at full speed from off-chip memory provides the following 
important benefits: 


e Easier prototyping and development work than possible with a device that can address only on-chip ROM, 
e Purchase of a standard off-the-shelf product rather than a semicustom mask-programmed device, 

e Ease of updating code, 

e Execution from external RAM, 

¢ Downloading of code from another microprocessor, and 

e Use of off-chip RAM to expand data storage capability. 

input/output 


The TMS320C10’s 16-bit parallel data bus can be utilized to perform |/O functions at burst rates of 40 
million bits per second. Available for interfacing to peripheral devices are 128 input and 128 output bits 
consisting of eight 16-bit multiplexed input ports and eight 16-bit multiplexed output ports. In addition, 
a polling input for bit test and jump operations (BIO) and an interrupt pin (INT) have been incorporated 
for multitasking. 


interrupts and subroutines 


The TMS320C10 contains a four-level hardware stack for saving the contents of the program counter 
during interrupts and subroutine calls. Instructions are available for saving the TMS320C10’s complete 
context. The instructions, PUSH stack from accumulator and POP stack to accumulator, permit a level 
of nesting restricted only by the amount of available RAM. The interrupts used in the TMS320C10 are 
maskable. 
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instruction set 


The TMS320C10’s comprehensive instruction set supports both numeric-intensive operations, such as 
signal processing, and general-purpose operations, such as high-speed control. The instruction set, explained 
in Tables 1 and 2, consists primarily of single-cycle single-word instructions, permitting execution rates 
of better than 5 million instructions per second. Only infrequently used branch and 1|/O instructions are 
multicycle. 


The TMS320C10 also contains a number of instructions that shift data as part of an arithmetic operation. 
These all execute in a single cycle and are useful for scaling data in parallel with other operations. 


Three main addressing modes are available with the TMS320C10 instruction set: direct, indirect, and 
immediate addressing. 


direct addressing 


In direct addressing, seven bits of the instruction word concatenated with the data page pointer form the 
data memory address. This implements a paging scheme in which the first page contains 128 words and 
the second page contains 16 words. In a typical application, infrequently accessed variables, such as those 
used for servicing an interrupt, are stored on the second page. The instruction format for direct addressing 
is shown below. 


15 mam 13 #=@12 171 10 9 8 7 


aes ty er OUR SE ke 


Bit 7 = O defines direct addressing mode. The opcode is contained in bits 15 through 8. Bits 6 through 
O contain data memory address. 


The seven bits of the data memory address (dma) field can directly address up to 128 words (1 page) 
of data memory. Use of the data memory page pointer is required to address the full 144 words of data 
memory. 


Direct addressing can be used with all instructions requiring data operands, except for the immediate operand 
instructions. 


indirect addressing 


Indirect addressing forms the data memory address from the least significant eight bits of one of two auxiliary 
registers, ARO and AR1. The auxiliary register pointer (ARP) selects the current auxiliary register. The 
auxiliary registers can be automatically incremented or decremented in parallel with the execution of any 
indirect instruction to permit single-cycle manipulation of data tables. The instruction format for indirect 
addressing is as follows: 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
ee 
Bit 7 = 1 defines the indirect addressing mode. The opcode is contained in bits 15 through 8. Bits 7 through 


O contain indirect addressing control bits. 


Bit 3 and bit O control the Auxiliary Register Pointer (ARP). If bit 3 = O, then the content of bit O is loaded 
into the ARP. If bit 3 = 1, then the content of ARP remains unchanged. ARP = O defines the contents 
of ARO as memory address. ARP = 1 defines the contents of AR1 as memory address. 
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Bit 5 and bit 4 control the auxiliary registers. If bit 5 = 1, then the ARP defines which auxiliary register 
is to be incremented by 1. If bit 4 = 1, then the ARP defines which auxiliary register is to be decremented 
by 1. If bit 5 and bit 4 are zero, then neither auxiliary register is incremented or decremented. Bits 6, 2, 
and 1 are reserved and should always be programmed to zero. 


Indirect addressing can be used with all instructions requiring data operands, except for the immediate 
operand instructions. 


immediate addressing 


The TMS320C 10 instruction set contains special ‘‘immediate’’ instructions. These instructions derive data 
from part of the instruction word rather than from the data RAM. Some useful immediate instructions are 
multiply immediate (MPYK), load accumulator immediate (LACK), and load auxiliary register immediate 
(LARK). 


TABLE 1. INSTRUCTION SYMBOLS 


a ie eneaegemeeerens .-(" eeeinnions 


Accumulator 

Data memory address field 
Addressing mode bit 
Immediate operand field 
3-bit port address field 


1-bit operand field specifying auxiliary register 
4-bit left-shift code 
3-bit accumulator left-shift field 
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TABLE 2. TMS320C10 INSTRUCTION SET SUMMARY 
ACCUMULATOR INSTRUCTIONS 


ae a OPCODE 
MNEMONIC DESCRIPTION INSTRUCTION REGISTER 


cal Roni ct 1514131211109 8 76543210 
0 


Absolute value of accumulator 

Add to accumulator with shift 

Add to high-order accumulator bits 

Add to accumulator with no sign 
extension 

AND with accumulator 

Load accumulator with shift 

Load accumulator immediate 

OR with accumulator 

Store high-order accumulator bits with 
shift 

Store low-order accumulator bits 
Subtract from accumulator with shift 
Conditional subtract (for divide) 

Subtract from high-order accumulator bits 
Subtract from accumulator with no sign 
extension 

Exclusive OR with accumulator 

Zero accumulator 

Zero accumulator and load high-order bits 
Zero accumulator and load low-order bits 


2 2 6o..°O4 © 2 © © @2@ DB Oo © Oo © co © Gi 


with no sign extension 


AUXILIARY REGISTER AND DATA PAGE POINTER INSTRUCTIONS 


on — OPCODE 
MNEMONI DESCRIPTION INST Ti 
ONIC SC Siesta ott STRUCTION REGISTER 


1514131211109 8 7 6 § 4 3 2 1 Q 
Load auxiliary register 
Load auxiliary register immediate 
Load auxiliary register pointer immediate 
Load data memory page pointer 
Load data memory page pointer immediate 
Modify auxiliary register and pointer 
Store auxiliary register 
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TABLE 2. TMS320C10 INSTRUCTION SET SUMMARY (CONTINUED) 
BRANCH INSTRUCTIONS 


NO NO OPCODE 
MNEMONIC DESCRIPTION ; eR 
cycies | woRDS STRUCTION REGISTER 


1514131211103 8 7 6 § 4321 9 
Uk @ elieO 605050 0 0 O2¢ 
4——- BRANCH ADDRESS ———® 
0.4, O50 0050 0 0 0:9 
<¢——\- BRANCH ADDRESS ———> 
tb 7 On Og 0. 0: Or 0 
<——- BRANCH ADDRESS ——®> 
Tatily, Bs Dic OO -0 0 056 
<——- BRANCH ADDRESS ———® 
0 caret icO.. 0: O1:.0-0 0 0.0:0 
<¢——— BRANCH ADDRESS ——> 
te 1 Oe Oe 0-0 0 0 
<——- BRANCH ADDRESS ———_ 
1+ (Quiche OO 02:00:90 0 0 0'n0 
—— BRANCH ADDRESS ——— 
Peddie Ae®0 0 0 OO 
<@—— BRANCH ADDRESS ——> 
Ot 0 1 02050;0 0 0 0 0 
<4——— BRANCH ADDRESS ———® 
t 1 Joye ws Ge O 0-0-0 
<@—— BRANCH ADDRESS ——® 
tbhs Veeduk Oc. 1 1 0.0 
Ten enO-9 -0eE4-0:;0 0 0 0 0 
<——— BRANCH ADDRESS ——— 
MRA 28 Fe OO TT ae 


Branch unconditionally 


Branch on auxiliary register not zero 


Branch if accumulator => O 
Branch if accumulator 
Branch on BIO = O 
Branch if accumulator 
Branch if accumulator 
Branch if accumulator 


Branch on overflow 


Branch if accumulator = O 
Call subroutine from accumulator 


Call subroutine immediately 


O10 = DmDo-o0o =-0207 0-0 -+70+0+0+0 > 
“a aG=—-.25D-+-0 +4204 OOO - 0=-0-+0, 0 = 
SO = B&D =a Db -6b > Obs 6-0 - 0-7 04862 PD & 
Ow we © 2D = oe BS eo = Dp os So = SS oO 


Return from subroutine or interrupt routine 


T REGISTER, P REGISTER, AND MULTIPLY INSTRUCTIONS 


NO NO OPCODE 
MNEMONIC DESCRIPTION INSTRUCTION REGISTER 


hie: weal Pia 1514131211109 8 76543210 
Add P register to accumulator CeCe? 1 1 Tan 
Load T register <q D-———__ > 
LTA combines LT and APAC into one 

instruction 

LTD combines LT, APAC, and DMOV into 

one instruction 


q——_ D ——_—_> 


Multiply with T register, store product in 
es , . ——— 
P register 
Multiply T register with immediate 
operand; store product in P register 


Load accumulator from P register G0 ae J 4 0 


Subtract P register from accumulator >}. -O 0 0-0 


yi 
TEXAS 
INSTRUMENTS 


POST OFFICE BOX 1443 @ HOUSTON, TEXAS 77001 


TMS320C€10 
DIGITAL SIGNAL PROCESSOR 


TABLE 2. TMS320C10 INSTRUCTION SET SUMMARY (CONCLUDED) 
CONTROL INSTRUCTIONS 


OPCODE 
INSTRUCTION REGI 
WORDS STRUCTIO GISTER 


1514131211109 8 7 6 5 4 


2 
Oo 


MNEMONIC DESCRIPTION 
CYCLES 


— 
— 


Disable interrupt 
Enable interrupt 
Load status register 


No operation 


POP stack to accumulator 
PUSH stack from accumulator 
Reset overflow mode 

Set overflow mode 

Store status register 


'Oo1o 6:0;,o O70) © 
ee ee ee ee ee a | 
a ee ee ee ee ee ie | 
a ee ee ee ee ee ee | 
ee ee ee ee ee fe 


= = »- AO NH - —| —= — 
. 
pce ole 


1/0 AND DATA MEMORY OPERATIONS 


N NO OPCODE 
MNEMONIC DESCRIPTION 
cyetes | WoRDS INSTRUCTION REGISTER 


O. 
1514131211109 8765 43210 

Copy contents of data memory location 1 , 

into next location 

Input data from port 2 1 

Output data to port 2 1 

Table read from program memory to data 3 1 

RAM 

Table write from data RAM to program 3 1 


development systems and software support 


Texas Instruments offers concentrated development support and complete documentation for designing 
a TMS32010-based microprocessor system. When developing an application, tools are provided to evaluate 
the performance of the processor, to develop the algorithm implementation, and to fully integrate the 
design’s software and hardware modules. When questions arise, additional support can be obtained by 
calling the nearest Texas Instruments Regional Technology Center (RTC). 


Sophisticated development operations are performed with the TMS32010 Evaluation Module (EVM), Macro 
Assembler/Linker, Simulator, and Emulator (XDS). In the initial phase of developing an application, the 
evaluation module is used to characterize the performance of the TMS320C10. Once this evaluation phase 
is completed, the macro assembler and linker are used to translate program modules into object code and 
link them together. This puts the program modules into a form that can be loaded into the TMS32010 
Evaluation Module, Simulator, or Emulator. The simulator provides a quick means for initially debugging 
TMS320C10 software while the emulator provides real-time in-circuit emulation necessary to perform 
system level debug efficiently. 


A complete list of TMS320C10 software and hardware development tools is given in Table 3. 
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TABLE 3. TMS320C10 SOFTWARE AND HARDWARE SUPPORT 


HOST OPERATING PART 
COMPUTER SYSTEM NUMBER 
TMS32010 MACRO ASSEMBLERS/LINKERS 
DEC VAX VMS TMDS3240210-08 
TI/IBM PC MS/PC-DOS TMDS3240810-02 
TMS32010 SIMULATORS 
DEC VAX VMS TMDS3240211-08 
TI/IBM PC MS/PC-DOS TMDS324081 1-02 
TMS32010 DIGITAL FILTER DESIGN PACKAGE (DFDP) 
TI PC MS-DOS DFDP-TI001 
IBM PC PC-DOS DFDP-IBMO0O1 
TMS32010 HARDWARE 
Evaluation Module (EVM) RTC/EVM320A-03 
Analog Interface Board (AIB) RTC/EVM320C-06 
Emulator: 
XDS/22 TMDS3262210 
Enhanced XDS/22 (available early 1986) TMDS3262211 


absolute maximum ratings over specified temperature range (unless otherwise noted)! 


Re ER ri 3 on RTE eG Pee ers 53 4 Mi eee ange ce ar Nhe i -0.3Vto7V 
a i ee Spee Sete a Pe y MRA GD GEE wed hs alg 9k SAW oe See eee =O S-¥ t0°18.V 
RA Ae Gah Aca oS Reiter ne A mo RR a ae as Be a Ree -—0:3 V to 15 V 
Cemmcrrcrnnre tus eee Smee 1 ec ae ee ca ce a Oe Pa OP Pe ee rks 0.4 W 
Air temperature range above operating device ............ 0. ee ee ns O°C to 70°C 
Ce ce mermrtire fore ee at a de oe EER AS as aS ee a ee = $5 °C.to. + 196°C 


TStresses beyond those listed under ‘‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating 
only and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions”’ section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. 

TAIl voltage values are with respect to Vss. 


recommended operating conditions 


ey se ee 

458 55 
ivgip ses Supe polagee yoo c aecr eo Aa) «(RIS men One cmanladue ron feslcmedt 

VIH High-level input voltage AN Deve ene csi 
cuKIN 


NOTE 1. For dual-in-line package: 
RejA = 51.6°C/Watt 
Rajic = 16.6°C/Watt. 
For plastic chip-carrier package: 
Raja = 70°C/Watt 
Rejc = 20°C/Watt. 
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electrical characteristics over specified temperature range (unless otherwise noted) 


PARAMETER TEST CONDITIONS 
VOH High-level output voltage IOH = MAX 3 eee 
VOL Low-level output voltage lo. = MAX 0.3 0.5 


| Off-stat tout t V = MAX Vo wiki he died A 
oT ee eae ae il Vo = 0.4V 
i____Tnput current = Vas © Voc 


V\ 
- Data bus 
Data bus 


TAIl typical values except for Icc are at Vcc = 5 V, Ta = 25°C. 
ticc characteristics are inversely proportional to temperature; i.e., IC¢¢ decreases approximately linearly with temperature. 
$value derived from characterization data and not tested. 


f = 1 MHz, 


All other pins O V 


CLOCK CHARACTERISTICS AND TIMING 
The TMS320C10 can use either its internal oscillator or an external frequency source for a clock. 


internal clock option 


The internal oscillator is enabled by connecting a crystal across X1 and X2/CLKIN (see Figure 1). The 
frequency of CLKOUT is one-fourth the crystal fundamental frequency. The crystal should be fundamental 
mode, and parallel resonant, with an effective series resistance of 30 ohms, a power dissipation of 1 mW, 
and be specified at a load capacitance of 20 pF. 


PARAMETER TEST CONDITIONS | MIN NOM MAX | 
Crystal frequency f, O°C — 70°C 
C1, C2 o°c - 70°C 


: Ane : 
i Ri 


FIGURE 1. INTERNAL CLOCK OPTION 
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external clock option 


An external frequency source can be used by injecting the frequency directly into X2/CLKIN with X11 left 
unconnected. The external frequency injected must conform to the specifications listed in the table below. 


timing requirements over recommended operating conditions 


Eg eg ee RN 
tc(MC) Master clock cycle time 48.78 150 OB. cy 
ric) Rise time master clock input ST ee Oe | te 
tiMc) Fall time master clock input ee ne 


tw(MCP) Pulse duration master clock 0.475t.(¢) 0.525t,(c) 
tw(MCL) Pulse duration master clock low, tc(mc) = 50 ns 


tw(MCH Pulse duration master clock high, tec) = 50 ns 


switching characteristics over recommended operating conditions 


PARAMETER TEST CONDITIONS | MIN NOM MAX | 


tc(c) | CLKOUT cycle time! 
tr(C) CLKOUT rise time 


UNIT 


: R, = 8250 
tf(C) CLKOUT fall time CL = 100 pF 
tw(CL) Pulse duration, CLKOUT low Med Finis 4 


tw(CH) Pulse duration, CLKOUT high 
td(MCC) Delay time CLKINt to CLKOUT!+ 


"teic) is the cycle time of CLKOUT, i.e., 4*tc(pac) (4 times CLKIN cycle time if an external oscillator is used). 
Values given were derived from characterization data and are not tested. 
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PARAMETER MEASUREMENT INFORMATION 


2.15 V 


R_ = 8250 


FROM OUTPUT 
UNDER TEST TEST 


POINT 


i C, = 100 pF 


FIGURE 2. TEST LOAD CIRCUIT 


(a) INPUT 


- Ke ———— Von (MIN) 
0.8 V—™ 
0 
(b) OUTPUTS 


FIGURE 3. VOLTAGE REFERENCE LEVELS 
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clock timing 


P| (© timc) (\¢——— PF twiMCH) 
i ‘aes tc(MC) ae | aes 1 tw(McpP) ! 


| { i 


: 
| be—ab- twimcr 
1 TMC) —pl ke 
————_____ —_—__—_—___—_» 
le—r- tumcc' ee % 
| | 


l 


| 
| 
ae I+ tric) ! 
\—_—$—_— $70) 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 
Tta (McC) and tw(MCP) are referenced to an intermediate level of 1.5 volts on the CLKIN waveform. 


MEMORY AND PERIPHERAL INTERFACE TIMING 


switching characteristics over recommended operating conditions 


UNIT 


; Delay time CLKOUT}! to 
dj address bus valid (see Note 4) 


td6 Delay time CLKOUT! to WE! RL = 8259, Yateic)- 5! Yate(cy +15 
td7 Delay time CLKOUT! to WET Cy = 100 pF, 
See Figure 2 


Yatc(c) + 65 
Yateic)- 5! 


Yato(c) + 301 


data bus OUT valid 

Time after CLKOUT! that data 
Sand Time after CLKOUT! that data 

bus stops being driven 


ty Data bus OUT valid after CLKOUTJ 


NOTE 3: Address bus will be valid upon WET, DENT, or MENT. 
TThese values were derived from characterization data and are not tested. 


ion ae, 
ene. =| 
es 
eae 
Ena | 
es | 


timing requirements over recommended operating conditions 


TEST 
CONDITIONS 


tsu(D) Setup time data bus valid prior to CLKOUT 


tsu(A-MD) Address bus setup time prior to MEN! or DEN! Cy. = 100 pF, 
th(D) Hold time data bus held valid after CLKOUT See Figure 2 


NOTE 4: Data may be removed from the data bus upon MENT or DENT preceding CLKOUT\. 
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LOOZZ SVX3L ‘NOLSNOH @ EvvL KOS 3DI540 LSOd 


SLNAWNULSN] 


(ye SVX4L 


SL-D 


pees Aiowauw 


CLKOUT \ / \ / 
ta2 see Si: 
ta3 + le— : | 
le wd _ I tou(a-MD) | 
TX AAAAAAAAASAY LAAAAAAAAAAAAAAAARAD 
A11-A0 LARRY) ADDRESS BUS VALID OOOO E KARR) 
000600 6.6.6.6.66 9000406096000 06066 
D15-DO INSTRUCTION IN VALID 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


= 
m 
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dOSSIIOdd IWNDIS IWLIDIG 


OLIOCESINL 
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SLINAWNAULSN 


LOOZZ SVX31L ‘NOLSNOH @ E€vvl XO 3DId40 LSOd 


MEN 

A11-A0O 
LEGEND: 
1 TBLR INSTRUCTION PREFETCH 7. ADDRESS BUS VALID 
es DUMMY PREFETCH 8. ADDRESS BUS VALID 
3. DATA FETCH 9. INSTRUCTION IN VALID 
4. NEXT INSTRUCTION PREFETCH 10. INSTRUCTION IN VALID 
5. ADDRESS BUS VALID 11. DATA IN VALID 
6. ADDRESS BUS VALID 12. INSTRUCTION IN VALID 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


Bui} uoNonsjsul YIGL 
OLIOCESWL 


YOSSIIOUd IWNIIS IVLIDIG 


LOOZZ SVX31L ‘NOLSNOH @ EvvL KOE 3DISSO LSOd 


I 


SLNAWNYLISN 


oe SVX4L 


LL-9 


CLKOUT 


A11-A0 


D15-D0 


LEGEND: 


2a > Say > 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


TBLW INSTRUCTION PREFETCH 
DUMMY PREFETCH 

NEXT INSTRUCTION PREFETCH 
ADDRESS BUS VALID 
ADDRESS BUS VALID 
ADDRESS BUS VALID 


8. 
= B 
10. 
11. 


ADDRESS BUS VALID 
INSTRUCTION IN VALID 
INSTRUCTION IN VALID 
DATA OUT VALID 
INSTRUCTION IN VALID 


} UONONASU! AATEL 


Buiwi 


YOSSIIOdd TWNOIIS IVLIDIG 


OLIOZESWL 


SLD 


SLINAWNALSN 


(ye SVX4]_ 


LOOZZ SVX31 ‘NOLSNOH @ €Evvl XO 3DI550 1SOd 


Buiwi uononaysul NI 


5 
rm 
2 


De Bets, BON. ae Sear ey eps Oe See eee. Ags, MAE 
(AAA) XA A \AAAAAAA/ TA AA 
XXX) 6.6.6.6 06666666 6666.4 
WY WY YY YY 
e— tua—} = \+— 
DEN \ y 


tsu(D) 
a lexi 


LEGEND: 


ADDRESS BUS VALID 
INSTRUCTION IN VALID 
DATA IN VALID 
INSTRUCTION IN VALID 


1. IN INSTRUCTION PREFETCH 
2. NEXT INSTRUCTION PREFETCH 
3. ADDRESS BUS VALID 

4, PERIPHERAL ADDRESS VALID 


ae aa ace + 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


OLIOZCESWL 


YOSSI90Ud IWNDIS IVLIDIC 


LOOLZ SVWX3L ‘NOLSNOH @ Evvl XOE 3DIS4O LSOd 


I 


SINAWNUYLISN 


(he SVX4]_ 


6L-9 


CLKOUT 
MEN 
A11-A0 
WE 
D15-DO 
LEGEND: 
1. OUT INSTRUCTION PREFETCH 5. | ADDRESS BUS VALID 
2. | NEXT INSTRUCTION PREFETCH 6. INSTRUCTION IN VALID 
3. | ADDRESS BUS VALID 7. DATA OUT VALID 
4. PERIPHERAL ADDRESS VALID 8. INSTRUCTION IN VALID 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 
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RESET (RS) TIMING 


timing requirements over recommended operating conditions 


a ee ee ee ie ee) is 
tsu(R) Reset (RS) setup time prior to CLKOUT. See Note 5. Se Sees ae 


tw(R) RS pulse duration 


switching characteristics over recommended operating conditions 


PARAMETER pen: UNIT 
CONDITIONS 


tq11 ) ta11 Delay time DENT, WEt, and MENT from FS time DENT, WEt, and MENT from RS = 8250, 2a ee 


at 100 pF, 
tdis(R) Data bus disable time after RS FE Yatc(c) + 507 2.3 


NOTE 5: RS can occur anytime during a clock cycle. Time given is minimum to ensure synchronous operation. 
TThese values were derived from characterization data and are not tested. 


reset timing 


ke—o}- tsuih) je >t—tsuih) 


acca | 
MEN NOTE 10 | 


ta11 
tdis(R) nee 


D15-D0 DATA DATA IN FROM DATA IN FROM 
OUT PC ADDR 0 PC ADDR PC +1 
DATA SHOWN RELATIVE TO WE 
= me Re Oe 


AB = ADDRESS BUS 
Ye snes AB = PC AB = PC + 1 - AB = PC = 0 AB = PC + 1 


NOTES: 2. Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise 
noted. 


6. RS forces DEN, WE, and MEN high and tristates data bus DO through D15. AB outputs (and program counter) are synchronously 
cleared to zero after the next complete CLK cycle from IRS. 
7. RS must be maintained for a minimum of five clock cycles. 
8. Resumption of normal program will commence after one complete CLK cycle from TRS. 
9. Due to the synchronizing action on RS, time to execute the function can vary dependent upon when TRS or JRS occur in 
the CLK cycle. 
10. Diagram shown is for definition purpose only. DEN, WE, and MEN are mutually exclusive. 
11. During a write cycle, RS may produce an invalid write address. 
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INTERRUPT (INT) TIMING 


timing requirements over recommended operating conditions 


Pees SS error) eo me 
ini Se 


Setup time INT! before CLKOUT! 


tsu(INT 


interrupt timing 


Jeo p suinn 


| 
'f(INT) —p 
sencuaee 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


+ 


1/O (BIO) TIMING 


timing requirements over recommended operating conditions 


tsu(lo Setup time BIO! before CLKOUT! 


BIO timing 


CLKOUT eS Re, 


SS i 


10] je | 
sche Nita ese 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 
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THERMAL DATA 


thermal resistance characteristics 


R R 
PACKAGE Lop sol 
(°C/W) | (°C/W) 
40-pin plastic dual-in-line package 5755 16.6 
44-lead plastic chip carrier package 70 20 


MECHANICAL DATA 


40-pin plastic dual-in-line package 


53,1 (2.090) MAX 


EITHER OR BOTH 
INDEX MARKS 


® 
€ 15,24+0,25 ¢ 


(0.600 + 0.010) 0,51 a 5,08 (0.200) MAX 


ae SEATING nae YY 
90° 7 - 


0,28 +0,08 0,457+0,076 |e 
(0.011 + 0.003) (0.018 + 0.003) 0,84 (0.033) MIN 
PIN SPACING 2,54 (0.100) T.P. 
(SEE NOTE A) 1,52 (0.060) NOM 


2,92 (0.115) MIN 


2-41 (0.095) 
1,40 (0.055) 


ALL DIMENSIONS ARE IN MILLIMETERS AND PARENTHETICALLY IN INCHES 


NOTE A: Each pin centerline is located within 0,254 (0.010) of its true longitudinal position. 
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44-lead plastic chip carrier package 
17,65 (0.695) 
17,40 (0.685) 


16,66 (0.656) 
16,51 (0.650) 


17,65 (0.695) 
17,40 (0.685) 


16,66 (0.656) 


_—_—_—— 


16,51 (0.650) 


4,57 (0.180) 
4,19 (0.165) 


3,05 (0.120) 
2,29 (0.090) 


TYP 0,51 (0.020) 
MIN 


0,533 (0.021) _ } 


0,330 (0.013) 


16,00 (0.630) 
14,99 (0.590) 


a & 


1,27 (0.050) 
TYP 


ALL DIMENSIONS ARE IN MILLIMETERS AND PARENTHETICALLY IN INCHES 


43 
TEXAS 
INSTRUMENTS 


POST OFFICE BOX 1443 @ HOUSTON, TEXAS 77001 


C-23 


D. TMS32020/TMS320C25 System Migration 


This appendix contains information necessary to upgrade a TMS32020 program to 
a TMS320C25-based system. The information consists of a detailed list of the 
programming differences and hardware and timing differences between the two 
processors. The following items should be considered in migrating from the 
TMS32020 to the TMS320C25: 


1) 


2) 


3) 


4) 


5) 


6) 


7) 


8) 


9) 


Instructions are fully compatible at the object code level. TMS32020 object 
(memory image) code can be used directly on the TMS320C25 processor. 


Instructions are compatible at the source code level. The NORM instruction that 
previously had no operands now has an optional operand to define the auxiliary 
register modification. Any comments on the same line in the source code file 
will be interpreted as the operand if no other operand is specified. NORM 
instructions should be modified to specify the default operand, *+. 


Execution cycle timings of instructions have been modified. Most TMS320C25 
instructions execute in a single machine cycle. The number of cycles for some 
multicycle instructions have been changed. Refer to Appendix E for detailed 
information on instruction cycle timings. By following the entries in this 
appendix, the key timing differences can be noted. 


The IDLE instruction automatically sets the INTM bit in status register STO to 
a zero. This assures that an external interrupt will ‘wake up’ the processor. The 
instruction also requires three memory cycles to execute on the TMS320C25 
rather than one as on the TMS32020. 


In general, all branch, call, and return instructions that reload the program 
counter (PC) should be counted as three-cycle instructions when evaluating 
code execution timings on the TMS320C25. 


The store instructions (SACH, SACL, etc.) execute in one less cycle on the 
TMS320C25 than on the TMS32020 when data is stored to external data 
memory. 


The MAC and MACD instructions require one extra cycle, going from three to 
four cycles. The extra cycle is in the instruction read and setup overhead, and 
repeated execution will be one cycle per execution as on the TMS32020. 


The delay for a new memory configuration to become effective when using the 
CNFD or CNFP instructions on the TMS320C25 is two instruction fetches (for 
single-cycle instructions) when executing from external memory or internal 
ROM, as compared to one instruction fetch for the TMS32020. Thus, on the 
TMS320C25, a CNFP instruction must be placed at location 65277 if execution 
is to continue from the first location in block BO. When execution is from internal 
RAM on the TMS320C25, however, this delay is one instruction fetch as on 
the TMS32020. 


The timer on the TMS320C25 is clocked by CLKOUT1 and counts PRD + 1 
CLKOUT1 cycles, whereas the timer on the TMS32020 is clocked by 
CLKOUT1/4 and counts 4 x PRD cycles. Therefore, to count an equivalent 
amount of time on the TMS320C25 using the same input clock frequency, PRD 
values from the TMS32020 must first be multiplied by four and then decre- 
mented by one. If different input clock frequencies are used, this must also be 
accounted for by multiplying the PRD value for the TMS320C25 obtained above 
by the ratio of the TMS320C25 input clock frequency to the TMS32020 input 
clock frequency. 
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10) On the TMS320C25, both the timer (TIM) and period (PRD) registers are 
initialized to >FFFF on reset, while on the TMS32020, only the TIM register is 
initialized. 


11) Several bits (C, HM, and FSM) have been added to status register ST1 on the 
TMS320C25, as shown below. 


TMS32020 Status Register ST1: 


14 te SG Se ee ee ee ees es 8 
ee ER Tee oped oe 
TMS320C25 Status Register S11: 


TS be bo ee a ee ee 8 7 6 5 4 3 2 1 
[ane Tener Bixee [11 [amis xe [ro foo Pa 


The FSM, HM, and C status register bits are initialized by reset and are all set 
to one when reset occurs. Note that the new bits are assigned polarities in such 
a way that the values of the corresponding bits on the TMS32020 invoke a 
TMS32020-like operation on the TMS320C25. 


The SXM and PM status register bits that were previously uninitialized on the 
TMS32020 are now initialized by reset on the TMS320C25. When the 
TMS320C25 is reset, SXM is set to one, and the PM bits are set to zero. 


12) There are four differences between the serial ports on the TMS32020 and 
TMS320C25 that impact system migration. The two major differences are that 
the serial port on the TMS320C25 is double-buffered and is fully static in 
operation. Double-buffering greatly increases the amount of time available for 
processing serial port interrupts. Fully static operation effectively places no 
lower limit on serial port clock frequency. Neither of these features is present 
on the TMS32020. 


Another difference in serial port operation between the two processors is that 
serial port interrupts are generated half of a CLKR or CLKX cycle later on the 
TMS320C25 than they are on the TMS32020. Specifically, on the TMS32020, 
RINT and XINT are generated on the falling edge of CLKR and CLKX, respec- 
tively, during transfer of the last bit. On the TMS320C25, RINT and XINT are 
generated on the rising edge of CLKR or CLKX after the last bit has been 
transferred. This should not be critical for TMS32020 programs running on the 
TMS320C25 since double-buffering of the serial port on the TMS320C25 
allows more time for processing of serial port interrupts. Some modification of 
TMS32020 programs may, however, be required to take advantage of the 
double-buffering, depending on how serial port interrupt servicing is imple- 
mented. 


Finally, when operating the TMS320C25 serial port in byte mode, DRR behaves 
differently than it does on the TMS32020. On the TMS32020, the contents of 
the most significant byte of DRR remain unchanged once byte mode is initiated 
by executing a FORT instruction. On the TMS320C25, however, each time a 
new byte is received, the previous contents of the least significant byte of DRR 
are transferred to the most significant byte of DRR. Figure D-1 illustrates the 
behavior of DRR on both the TMS32020 and the TMS320C25 processors. 


D-2 


Appendix D 


TMS320C25 TMS32020 


s 
” 
wo 
™ 
wn 
wo 


MSB LSB 
Initial 
Conditions 


After 1st Receive 
(Byte ‘A’) 


After 2nd Receive 
(Byte 'B’) 


Etc. 


Figure D-1. Serial Port System Migration 
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E. TMS320C25 Instruction Cycle Timings 


This appendix details the instruction cycle timings for the TMS320C25. Table E-1 
lists the instructions according to cycle classification. 


Table E-1. TMS320C25 Instructions by Cycle Class 


CLASS INSTRUCTION 


ADD ADDC ADDH ADDS ADDT AND BIT BITT DMOV LAC 
LACT LPH Lt LTA LTD LTP LTS MPY MPYA MPYS 
MPYU PSHD' OR RPT SQRA SQRS _ SUB SUBB SUBC SUBH 
SUBS SUBT XOR ZALH ZALR ZALS_ (RPT not repeatable) 


ae ae ES Se a are. 
| oI.) -PQPD . SACH SACL “SAR -. “ORH> “SPL S6T..” Sort 
IV 


ABS ADDK ADRK APAC CMPL CMPR CNFD- CNFP_ DINT ~ EINT 
FORT LACK LARK LARP LDPK MAR MPYK NEG NOP NORM 
PAC POP PUSH RC RFSM RHM ROL ROR ROVM- RPTK 
RSXM RTC RTXM RXF SBRK SC SFL SFR SFSM SHM 
SOVM SPAC- SPM SSXM STC STXM SUBK- SXF ZAC 

(ADDK, ADRK, LACK, LARK, LDPK, MPYK, RPTK, SBRK, SPM, 

SUBK, and ZAC not repeatable) 


V ADLK ANDK LALK LRLK ORK SBLK XORK 
(All not repeatable) 


MAC _MACD 
Vil BANZ BBNZ_ BBZ BC BGEZ BGZ BIOZ BLEZ BLZ BNC 
BNV BNZ BV BZ (All not repeatable) 
Vill B BACC CALA CALL RET TRAP 
(All not repeatable) 


ee ee ae ee 
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Table E-2 and Table E-3 show the number of cycles required for a given TMS320C25 
instruction to execute in a given memory configuration. The column headings in the 
tables indicate the program source location and data destination or source. 


The number of cycles required for each instruction is given in terms of the 
program/data memory and |/O access times as defined in the following listing: 


p - Program memory wait states. Represents the number of clock cycles the 
device waits for external program memory to respond to an access. Tac Is 
the access time, in nanoseconds, (maximum) required by the TMS320C25 
for an external memory access to be made with no wait states. Tmem Is the 
memory device access time, and Tp is the clock period (4/crystal 


frequency). 

p= 0; If Tmem s Tac 

= i se If Tac < Tmem Ss (Tp + Tac) 

p= 2; If (Tp + Tac)< T mem s (Tp x 2 + Tac) 

p =k; If [Tp x (k-1) + Tac]< T mem s (Tp x k + Tac) 


d - Data memory wait states. Represents the number of cycles the device must 
wait for external data memory to respond to an access. This number is 
calculated in the same way as the p number. 


i - |/O memory wait states. Represents the number of cycles the device must 
wait for external |/O memory to respond to an access. This number is 
calculated in the same way as the p number. 


The other abbreviations used in the tables and their meanings are as follows: 


PI - The instruction executes from internal program memory (RAM). 

PR - The instruction executes from internal program memory (ROM). 

rE - The instruction executes from external program memory. 

DI - The instruction executes using internal data memory. 

DE - The instruction executes using external data memory. 

INT - Interrupt. 

n - The number of times an instruction is executed when using the RPT or 


RPTK instruction. 


Table E-2. Cycle Timings for Cycle Classes When Not in Repeat Mode 


Se ee ee ae eee oe 
a a a eae ee ie eee el oe 
St ee ee 
eee. ee ee ee 
ECA MCSE AS A SRS RS 
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Table E-2. Cycle Timings for Cycle Classes When Not in Repeat Mode (Concluded) 


CLASS PE/DI PE/DE PR/DI PR/DE 
vi ) 


Table is in on-chip RAM: 
3 4+d 5+d+2p 4 


Table is in on-chip ROM: 
4 5+d 5+d+2p 
Table is in external memory: 
4+p 5+d+p 5+d+3p 
Vil True Conditions: 


Destination is on-chip RAM: 
2 


Destination is on-chip ROM: 
2 


Destination is external memory: 
STD 
False Condition: 
Destination is anywhere: 


Vill Destination is on-chip RAM: 
2 


Destination is on-chip ROM: 
3 


Destination is external memory: 
3+p 


x< 


1+ 2+dt+i 2+pti 3+d+pti 1+) 2+dt+i 
Table is in on-chip RAM: 
2 2+d 3+d+p 


Table is in on-chip ROM: 
3 3+d 4+d+p 


Table is in external memory: 
3+p 3+d+p 4+d+2p 
Table is in on-chip RAM: 
2 3+d 4+d+p 


Table is in on-chip ROM: 


as 


not applicable 


Table is in external memory: 


2+p 3+d+p 3+2p 4+d+2p 
XIII Source data is in on-chip RAM: 
3 3+d 3+2p 3+d+2p 
Source data is in external memory: 
4+d 4+2d 4+d+2p 4+2d+2p 
XIV Table is in on-chip RAM: 
3 Std 4+d+2p 


Table is in on-chip ROM: 
4 4+d 4+d+2p 


Table is in external memory: 
4+p 4+d+p 4+d+3p 


(Interrupt) destination is on-chip ROM 
3 (minimum waits for INT) 


XV 


(Interrupt) destination is external memory 
3+2p (minimum waits for INT) 
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Table E-3. Cycle Timings for Cycle Classes When in Repeat Mode 


Po | ene nee einen ee See et | tenend 
a en een eee Seeength fe) anna 
SSP AERO PRS CRT 8 7 

ee ee ee Serene 
ee ee ee 


Table is in on-chip RAM: 
2+n 2+2n+nd 3+n+2p 3+2n+nd+2p 3+n 3+2n+nd 


Table is in on-chip ROM: 
3+n 3+2nt+nd 3+n+2p 3+2n+nd+2p 3+n 3+2n+nd 


Table is in external memory: 
3+n+np 3+2n+nd+np 3+n+np+2p 3+2n+nd+np+2p 3+n+np 3+2n+nd+np 


oe ee not repeatable 
Vill not repeatable 


Bee Se 1+n+ni 2n+ndtni 1+n+ptni 1+2n+nd+ptni 1+n+ni 2n+nd+tni 
n+ni 2n+nd+tni Tentp?ni—._Ee2n end ep thi n+nitni 2n+nd+ni 
Xl Table is in on-chip RAM: 
1+n 1+n+nd 2+n+p 2+n+nd+p 2+n+nd 
Table is in on-chip ROM: 
2+n 2+n+nd 3+n+p 3+n+nd+p 3+n 3+n+nd 
Table is in external memory: 
2+n+np 1+2n+nd+np 3+ntnptp 2+2nt+nd+np+p 3+n+np 2+2n+nd+np 


XII Table is in on-chip RAM: 
1+n 2+n+nd 2+n+p 3+n+nd+p 3+n+nd 


Table is in on-chip ROM: 
not applicable 


Table is in external memory: 


1+n+np 1+2n+nd+np 2+n+np+p 2+2n+nd+np+p 2+n+np 2+2n+nd+np 
XIII Source data is in on-chip RAM: 
2+n 2+n+nd 2+n+2p 2+n+nd+2p 2+n 2+n+nd 
Source data is in external memory: 
3+n+nd 2+2n+2nd 3+n+nd+2p 2+2n+2nd+2p 3+n+nd 2+2n+2nd 


XIV Table is in on-chip RAM: 
2+n 2+n+nd 3+n+2p 3+n+nd+2p 3+n+nd 


Table is in on-chip ROM: 
3+n 3+n+nd a+atZp 3+n+nd+2p 3+n 3+n+nd 


Table is in external memory: 
3+n+np 2+2nt+ndt+np 3+nt+np+2p 2+2n+ndt+np+2p 3+n+np 2+2n+nd+np 


not repeatable 


x 
| 


E 


‘ 
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F. TMS320C25 Development Support/Part 
Order Information 


Texas Instruments offers extensive development support and complete documenta- 
tion with the TMS320 family of digital signal processors (see Figure F-1). Tools are 
provided to evaluate the performance of the processor, develop algorithm imple- 
mentations, and fully integrate the design’s software and hardware modules. 


The development support available for the TMS320C25 is listed below. 
e Macro Assembler/Linker 
* Simulator 


& Emulator (XDS/22) 


Key features, a description, and part order information for each TMS320C25 devel- 
opment support tool can be found in the following pages. Contact the nearest TI field 
sales office for availability or further details (see list of sales offices and distributors 
at end of book). 


Figure F-1. TMS320 Family Development Support 
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F.1 TMS320C25 Macro Assembler/Linker 


The TMS320C25 Macro Assembler translates TMS320C25 assembly language 
source code into executable object code. The assembler allows the programmer to 
work with mnemonics rather than hexadecimal machine instructions and to reference 
memory locations with symbolic addresses. The macro assembler supports macro 
calls and definitions along with conditional assembly. 


The TMS320C25 Linker permits a program to be designed and implemented in 
separate modules that will later be linked together to form the complete program. 
The linker resolves external definitions and references for relocatable code, creating 
an object file that can be executed by the TMS320C25 Simulator, TMS320C25 
Emulators, or TMS320C25 processor. 


The following key features distinguish the TMS320C25 Macro Assembler/Linker: 


Macro Capabilities and Library Functions 
Conditional Assembly 

Relocatable Modules 

Complete Error Diagnostics 

Symbol Table and Cross Reference 


The TMS320C25 Macro Assembler/Linker is currently available for the VAX/VMS, 
T| PC/MS-DOS, and IBM PC/PC-DOS operating systems. 


HOST OPERATING PART NUMBER 
SYSTEM 
DEC VAX VMS TMDS3242210-08 1600 BPI MAG TAPE 
TI/IBM PC MS/PC-DOS TMDS3242810-02 5 1/4” FLOPPY 


F.2 TMS320C25 Simulator 
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The TMS320C25 Simulator is a software program that simulates operation of the 
TMS320C25 to allow program verification. The debug mode enables the user to 
monitor the state of the simulated TMS320C25 while the program is executing. The 
simulator uses the TMS320C25 object code produced by the TMS320C25 Macro 
Assembler/Linker. During program execution, the internal registers and memory of 
the simulated TMS320C25 are modified as each instruction is interpreted by the host 
computer. Once program execution is suspended, the internal registers and both 
program and data memories can be inspected and/or modified. In addition, files can 
be associated with the |/O ports. 


The following features highlight simulator capability for effective TMS320C25 soft- 
ware development: 


Program Debug/Verification 

Single-Step Option 

Trace/Breakpoint Capabilities 

Full Access to Simulated Registers and Memories 
[/O Device Simulation 


The TMS320C25 Simulator is currently available for the VAX/VMS, Tl PC/MS-DOS, 
and IBM PC/PC-DOS operating systems. 


HOST OPERATING PART NUMBER 
SYSTEM 
DEC VAX VMS TMDS3242211-08 1600 BPI MAG TAPE 
TI/IBM PC MS/PC-DOS TMDS3242811-02 5 1/4” FLOPPY 
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F.3 TMS320C25 Emulator 


The TMS320C25 Emulator (XDS/22) is a user-friendly system that has all the 
features necessary for realtime in-circuit emulation. This allows integration of hard- 
ware and software modules in the debug mode. By setting breakpoints based on 
internal conditions or external events, execution of the program can be suspended 
and control given to the debug mode. In the debug mode, all registers and memory 
locations can be inspected and modified. Single-step execution is available. Full- 
trace capabilities at full speed and a reverse assembler that translates machine code 
back into assembly instructions also increase debugging productivity. Using a 
standard RS-232-C port, the object file produced by the TMS320C25 Macro 
Assembler/Linker can be downloaded into the emulator, which then can be 
controlled through a terminal. 


The XDS/22 provides 4K x 16 words of high-speed static RAM (zero wait states) 
for program memory and sockets for 4K x 16 words of high-speed static RAM for 
user-supplied data memory. It also has the capability of executing out of target 
memory to utilize the full TMS320C25 program/data address range. For multiproc- 
essing configurations, up to nine emulators can be daisy-chained together. 


The XDS/22 emulator is a completely self-contained system with power supply. This 
model also includes memory expansion with 64K x 16 words of DRAM (two wait 
states). This slower memory is configurable by the user as either all program memory, 
all data memory, or 32K words of each. With three RS-232-C ports, the XDS/22 
Emulator can be interfaced to a terminal, host computer for source or object 
downloading/uploading capabilities, and printer or PROM programmer. 


The key features of the XDS/22 Emulator are as follows: 


Full-Speed In-Circuit Emulation 

4K Words of Program Memory for User Code 

Program/Data DRAM Memory Expansion to 64K Words 

Hardware Breakpoint on Program, Data, or |/O Conditions 

2K Words of Full-Speed Hardware Trace 

Use of Target System Crystal, Internal Crystal, or External Clock Signal 
Up to Ten Software Breakpoints 

Single-Step Option 

Assembler/Reverse Assembler 

Host-Independent Upload/Download Capabilities to/from Program or Data 
Memory 

Ability to Inspect and Modify Registers and Program/Data Memory 
Multiprocessor System Development 


MODEL PART NUMBER POWER SUPPLY 
XDS/22 TMDS3262221 (Included) 


Figure F-2 shows a block diagram of a typical system configuration using the 
TMS320C25 XDS/22 Emulator. 
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F.4 Device 
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pROaTAE ER HOST 

M 

ati OR COMPUTER 
LINE SYSTEM 

PRINTER 


TMS320C25 
XDS/22 
EMULATOR 


64K DRAM 
EXPANSION 


Figure F-2. TMS320C25 XDS/22 Emulator System Configuration 


Prefix Designators 


To provide expeditious system evaluations by customers during the product devel- 
opment cycle, Texas Instruments assigns a prefix designator with three options: TMX, 
TMP, and TMS. These prefixes are representative of the evolutionary stages of 
product development from engineering prototypes (TMX) through fully qualified 
production devices (TMS). This evolutionary development flow is defined below. 


TMX Experimental devices that are not representative of the final device's 
electrical specifications. 


TMP Final silicon die that conforms to the device’s electrical specifications 
but has not completed quality and reliability verification. 


TMS Fully qualified production devices. 


TMX devices are shipped against the following disclaimer: 
1) Product is experimental and its reliability has not been characterized. 
2) Product is sold “as is.” 


3) Product is not warranted to be exemplary of final production version if or when 
released by Texas Instruments. 


TMP devices are shipped against the following disclaimer: 
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1) Customer understands that the product purchased hereunder has not been fully 
characterized and the expectation of quality and reliability cannot be defined; 
therefore, Texas Instruments standard warranty refers only to the device’s 
specifications. 


2) No warranty of merchantability or fitness is expressed or implied. 


Note: 


Texas Instruments recommends that prototype devices (TMX or TMP) not be 


used in production systems since their expected end-use failure rate is undefined 
but predicted to be greater than standard qualified production devices. 


TMS devices have been fully characterized and the quality and reliability of the device 
has been fully demonstrated. Texas Instruments standard warranty applies. 


F.5 TMS320 Nomenclature 


In addition to the prefix, the device family name, the specific device name, package 
type, and temperature range are designated in the device nomenclature. Figure F-3 
provides a legend for reading the complete device name. 


TMS 320 C 25 FN L 


PREFIX Se —_ TEMPERATURE RANGE 


TMS = standard prefix L = O°C to 70°C 
SMJ = MIL-STD-883C S = ~55°C to 100°C 
M = -55°C to 125°C 
A = -40°C to 85°C 
FAMILY 
320 = signal processing family PACKAGE TYPE 
N = plastic DIP 
JD = ceramic DIP side-brazed 
TECHNOLOGY FN = plastic leaded CC 
C = CMOS GB = ceramic PGA 


FJ = ceramic leaded CC 
FD = leadiess ceramic CC 


DEVICE 
bs = ist-generation microprocessor/microcomputer 


os = 2nd-generation microprocessor 


Figure F-3. TMS320 Nomenclature 
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G. TMS320C25 Macro Assembler and Link 
Editor Installation 


This appendix contains step-by-step instructions for installing, verifying, and 
relinking the TMS320C25 Macro Assembler and Link Editor. This software can be 
installed on two operating systems: 


@ VAX/VMS (Digital Equipment Corporation VAX-11)' 
@ MS/PC-DOS (MS-DOS for the Tl PC and PC-DOS for the IBM PC)2 


The following style and symbol conventions are used to present information clearly 
and concisely: 


@ The symbol <CR> indicates that a carriage return should be entered. 
@ Screen displays are shown in a special font. 
# Portions of a display that are user responses are underscored. 


1 VAX-11 and VMS are trademarks of Digital Equipment Corporation. 


2 PC-DOS is a trademark of International Business Machines. 
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G.1 TMS320C25 VAX/VMS CrossWare Installation 


The TMS320C25 CrossWare tape was created with the VMS BACKUP utility. The 
package is contained in two directories, shipped in two save-sets. 


In the examples, replace <directory> with the name of the directory in which this 
package resides, e.g., DUA2:[DSP.ASM25]. Note the use of brackets in this section 
to indicate a directory. 


The following subsections include the sequence of steps used for restoring the 
directories of the Macro Assembler and Link Editor, installing command files, 
providing transparent access, verifying the installation procedure, and relinking the 
product components. A list of the product directories is also provided. 


G.1.1 Restoring the Distribution Tape to Disk 
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In the following examples, MFAQO is the tape drive name and DUA2 is the hard disk 
drive name. The tape drive and disk drive may have other names, dependent on a 
particular system. 


€ Mount the Tape 


Place the tape on a tape drive. Mount it by entering: 


ALLOC MFAO: <CR> 
MOUNT MFAO: /OVER=ID/FOR/DEN=1600 <CR> 


If the mount is successful, the screen displays: 


ASM25 MOUNTED ON MFAO 

¥ Restore the Macro Assembler 
Use the BACKUP utility to read the C25ASM save-set from the tape: 
BACKUP/LOG/VERIFY MFAO:C25ASM.BCK DUA2: [<directory>]*.* <CR> 


The CrossWare package can reside in either the user directory or a system 
directory. The examples copy the package into the user directory, copying the 
C25ASM.BCK directory structure on the tape into [<directory>] on disk DUA2. 


A README file explaining the Macro Assembler validation procedure is 
contained in this directory: 


[<directory>.C25ASM] README .DAT 
If not installing the Link Editor, skip the next step and unload the tape. 
& Restore the Link Editor 
Use the BACKUP utility to copy the LINKER save-set from the tape: 
BACKUP/LOG/VERIFY MFAOQ:LINKER.BCK DUA2: [<directory>]*.* <CR> 


The LINKER.BCK directory structure on the tape is copied into [<directory>] 
on disk DUA2. 


A README file explaining the Link Editor validation procedure is contained in 
this directory: 


[<directory>.LINKER] README.DAT 
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Dismount the Tape 


Dismount the tape by entering: 


DISMOUNT MFAO: <CR> 


Remove the tape from the drive. Deallocate the tape drive by entering: 


DEALLOCATE MFAQO: <CR> 


G.1.2 Installing Command Files 


Two command procedures are provided to ensure correct system-dependent parse 
features. If the VAX/VMS system runs under Version 2.5, use the PARSE.C25 
command procedure by renaming it PARSE.COM. If the system runs under Version 
3.0, use the default PARSE.COM. 


Set the default directory to the directory to which the Assembler and Linker have 
been restored. Edit the Assembler and Linker command files, replacing existing 
pathnames with the pathnames to which they have been restored: 


Edit the file: [<directory>.C25ASM] XASM.COM 


Insert the appropriate file pathnames in three places: 


For the two calls to the PARSE command, which appear within the first 
20 lines, insert the appropriate file pathname after @ and before PARSE: 


S$ @DUA2: [<directory>.C25ASM]PARSE 'P1' 


For the one RUN statement, which appears near the bottom of the file, 
insert the appropriate file pathname after RUN and before ASM32020: 


$ RUN DUA2: [<directory>.C25ASM]ASM32020 


Edit the file: [<directory>.LINKER] XLINKER.COM 


Substitute the appropriate file pathnames in three places: 


Two calls to the PARSE command, marked in the file by a preceding line 
KKKKKK ' 


S$ @[MOORE.LINKER]PARSE 'P1' 


Change them to: 


S$ @DUA2: [<directory>.LINKER]PARSE 'P1' 


One RUN statement near the end of the file. 


$ RUN[MOORE.LINKER] LINKER 


Change it to: 


$ RUN DUA2: [<directory>.LINKER] LINKER 
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G.1.3 Providing Transparent Access 


-$ X320 := 


Use the following procedure to provide transparent access to the Assembler and Link 
Editor for all users. After the directories are on disk, make the following assignments 
into the LOGIN.COM file: 


= @DUA2: [<directory>.C25ASM] XASM.COM 
$ XLINK :== @DUA2:[<directory>.LINKER] XLINKER.COM 


This defines the X320 and XLINK commands, which execute the Macro Assembler 
and Link Editor. Execute the Macro Assembler by entering X320 at the terminal in 
System Mode. Similarly, execute the Link Editor by entering XLINK. 


G.1.4 Verifying Installation 
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This verification procedure is not designed to perform an exhaustive test. It simply 
verifies that the installation procedures were executed correctly. It also provides 
familiarity with the basic operation and data flow of this package. 


The test procedure consists of creating a test directory, assembling three source files, 
and linking the assembler output files. 


1) Create a test directory. Copy the TEST.ASM, TEST1.ASM, TEST2.ASM, and 
TEST1.CON files from [.C25ASM] and [.LINKER] into the directory by entering 
these commands: 


CREATE/DIR [<userid>.TEST] <CR> 

SET DEF [<userid>.TEST] <CR> 
[<directory>.C25ASM]TEST.ASM * <CR> 
OPY [<directory>.LINKER]TEST1.ASM * <CR> 
OPY [<directory>.LINKER]TEST2.ASM * <CR> 
OPY [<directory>.LINKER]TEST1.CON * <CR> 


2) In System Mode, enter: X320 <CR> 


QD 


2) 


1 HAA 
Q 
Rg 
A) 
K 


Q 


For the first input parameter in each of the three assembler runs, enter 
TEST.ASM, TEST1.ASM, and TEST2.ASM, respectively (ASM is the default). 
The command procedure parses the pathname and generates defaults for the 
output listing and object files. Press the carriage return to accept the defaults, 
or specify user file pathnames as follows: 


$ X320 TEST <CR> 

Object file (TEST.MPO): <CR> 
Listing file (TEST.LIS):~ <CR> 
Messages (——TXE1:): <CR> 


S$ X320. TESTI 

Object file (TEST1.MPO): <CR> 
Listing file (TEST1.LIS): <CR> 
Messages (——TXE1:): <CR> 


$ X320 TEST2 

Object file (TEST2.MPO): <CR> 
Listing file (TEST2.LIS): <CR> 
Messages (——TXE1:): <CR> 


This creates the TEST.MPO, TEST.LIS, TEST1.MPO, TEST1.LIS, TEST2.MPO 
and TEST2.LIS files in the directory [<userid>.TEST]. 


3) In System Mode, enter: XLINK <CR> 


As the first input parameter, enter TEST1.CON. For the second and third 
parameters, the command procedure parses the pathname and generates 
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defaults for the output, load, and map files.. This procedure links the object files 
for TEST1 and TEST2 into a single executable object file in TEST1.LOD (CON 
is the default for the first parameter): 


oS“ XUN Test. ctr 
Linked. object file (TEST1.LOD): <CR> 
Map file (TEST1.MAP): <CR> 


This creates the files TEST1.LOD and TEST1.MAP. These files should agree 
with the precompiled versions in the product directories for the Macro Assem- 
bler and Link Editor. 


G.1.5 Relinking the Macro Assembler and Link Editor 


It should not be necessary to relink the Macro Assembler or Link Editor, but command 
files have been provided to allow for this contingency. 


To relink the Macro Assembler, edit the LINKASM.COM procedure file to put the 
correct pathname for the runtime library in the logical assignment statement. In 
System Mode, execute LINKASM.COM to relink the ASM32020.EXE file: 


S$ SET DEF [<directory>.C25ASM] <CR> 
$ @LINKASM <CR> eae 


Similarly, to relink the Link Editor, edit the LINKLINK.COM procedure file to put the 
correct pathname for the runtime library in the logical assignment statement. In 
System Mode, execute LINKLINK.COM to-relink the LINKER.EXE file: 


S$ SET DEF [<directory>.LINKER] <CR> 
$ @LINKLINK <CR> wt 


G.1.6 Product Directories 


The following listing contains the product directories found in the CrossWare pack- 
age. These two directories contain a total of 40 files. 


SET DEF [<userid>.<directory>] <CR> 
{Cine 


0 
v8) 


Directory [<directory>] 
C25ASM.DIR;1 LINKER.DIR;1 
Total: 2 files 


DIR [<directory>.C25ASM] <CR> 
Directory [<directory>.C25ASM] 


ASM.OBJ;1 ASM32020.EXE;1 ASMRTS.OLB;1 FORMO.ASM;1 
FORMO.LIS;1 FORMO.MPO;1 FORM1.ASM;1 FORM1.LIS;1 
FORM1.MPO;1 FORM2.ASM;1 FORM2.LIS;1 FORM2 .MPO;1 
FORMREST.ASM;1 FORMREST.LIS;1 FORMREST.MPO;1 LINKASM.COM;1 
PARSE .C2Z521 PARSE.COM;1 README.L1IS;1 TEST.ASM;1 
TEST. LIS#= TEST.MPO;1 XASM.COM;1 


Total: ‘23 files 


DIR [<directory>.LINKER] <CR> 
Directory [<directory>.LINKER. ] 


XLINKER.COM;1 LINKER.EXE;1 LINKER.OBJ;1 LINKLINK.COM;1 
LINKRTS.OLB;1 PARSE.C25;1 PARSE.COM;1 README .LIS;1 
TEST1.ASM;1 TEST1.CON;1 TEST1.LIS;1 TEST1.LOD;1 
TEST 1:..MAP.;.1 TEST1.MPO;1 TEST2.ASM;1 TEST2.LIS;1 


TEST2.MPO;1 
Total: 17 files 
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G.2 TMS320C25 MS/PC-DOS CrossWare 


The TMS320C25 CrossWare installation package is contained on a dual-density 
double-sided floppy diskette. The Macro Assembler and Link Editor execute in batch 
mode on MS-DOS (TI PC) and PC-DOS (IBM PC) systems. At least 256K bytes 
of memory space must be available. 


Instructions are included for both hard-disk systems and dual floppy-drive systems. 
The examples use these symbols for drive names: 


A: Floppy-disk drive for hard-disk systems or source drive for dual floppy-drive 
systems. 


B: Destination or system disk drive for dual floppy-drive systems. 
E: Winchester (hard disk) for hard-disk systems. 


The following subsections include a list of the files on the diskette and the sequence 
of steps used for restoring, executing, and testing the directories of the Macro 
Assembler and Link Editor. 


G.2.1 Diskette Files 
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@ The TMS320C25 Assembler portion of the diskette contains four files: an 
executable module and three test files. 


Executable Module: 


XASM.EXE Executes the Macro Assembler 


Test Files: 
FFT.ASM Source file for Assembler test program 
FFT.LST Correct output listing file for Assembler test program 
FFT.MPO Correct output object file for Assembler test program 


@ The TMS320C25 Linker portion of the diskette contains ten files: one executable 


module and nine test files. 
Executable Module: 

LINKER.EXE Executes the Link Editor 
Test Files: 


TST1.ASM Source file for test program #1 

TST1.LST Correct output listing file for test program #1 
TST1.MPO Correct output object file for test program #1 
TST2.ASM Source file for test program #2 

TST2.LSF Correct output listing file for test program #2 
TST2.MPO Correct output object file for test program #2 
LNKTST.CTL Linker test program (link control file) 

LNKTST.MAP Correct output listing file for the Linker test program 
LNKTST.LOD Correct output object file for the Linker test program 
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G.2.2 Restoring the Macro Assembler and Linker 


Instructions are provided for hard-disk systems and dual floppy-drive systems. If 
using a dual floppy-drive system, the MS/PC-DOS system diskette should be in drive 


B. 
1) 


2) 


3) 


Make a backup diskette of the Macro Assembler and Linker. 


% On MS-DOS, insert the source diskette in drive A. Enter: 


DISKCOPY A: A:/F/V <CR> 


The /F (format) switch tells MS-DOS to format the new (destination) 
diskette before copying begins. The /V (verify) switch tells MS-DOS to 
verify that the source and destination diskettes are identical after the copy 
has completed. 


e On PC-DOS, insert a blank diskette in drive A. Enter: 


FORMAT A: <CR> 


Then enter: 


DISKCOPY A: A: <CR> 


When MS/PC-DOS first prompts for the destination diskette, remove the source 
diskette and insert a blank diskette. Follow the prompts, removing and inserting 
the source and destination diskettes as directed. When MS/PC-DOS prompts: 


COPY ANOTHER (Y/N)? 
respond with N. 
Copy the Macro Assembler onto the hard disk or the system disk. 


On hard-disk systems, enter: 


COPY A:XASM.EXE E:*..*/V <CR> 


On dual floppy-drive systems, enter: 


COPY A:XASM.EXE B:*.*/V <CR> 
Copy the Link Editor onto the hard disk or the system disk: 


On hard-disk systems, enter: 


COPY A:LINKER.EXE E:*.*/V <CR> 


On dual floppy-drive systems, enter: 


COPY A:LINKER.EXE B:*.*/V <CR> 
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G.2.3 Executing the Macro Assembler 


To execute the Macro Assembler, enter: 
XASM <CR> 


The command line parser prompts for the source, listing, and object file names: 


Source File Enter the source file name (if the source file does not have an 
extension, then type the file name with an explicit ’.’). 

Listing File Enter the output listing file name. 

Object File Enter the output object file name. 


MS/PC-DOS creates defaults for the listing and object files and/or their extensions. 
The default extensions are: 


ASM Source file 
-LST Listing file 
.MPO Object file 


In the following examples, two special command characters are used: semicolon (;) 
and comma (,). Using a semicolon (;) followed immediately by a carriage return at 
any time after the first filename in a command line selects the default responses to 
the remaining prompts. The comma (,) separates responses to successive prompts. 


Examples: 


XASM <filename>.SRC; 

- Uses <filename> with extension SRC. 

- Generates defaults for the listing file <filename.LST> and object file 
<filename>.MPO. 


XASM <filename>; 
= Uses <filename> with default extension ASM. 
- Generates defaults for the listing and object files as indicated above. 


XASM <filename>,<newname>; 
= Uses <filename> with default extension ASM. 
- Generates listing file <newname>.LST and object file <newname>.MPO. 


XASM <filename>,<newname> 
- Uses <filename> with default extension ASM. 
- Generates listing file <newname>.LST and prompts for object file name. 


G.2.4 Executing the Link Editor 


G-8 


To execute the Linker, enter: 


LINKER <CR> 


The command line parser prompts for the control, linkmap, and load file names. 


Control File Enter the control file name with extension (if the control file does 
not have an extension, type the file name with an explicit ’.’). 

Map File Enter the linkmap file name with extension. 

Load File Enter the load module file name with extension. 


MS/PC-DOS generates defaults for the linkmap and load files and/or their exten- 
sions. The default extensions are: 


ere. Control file 
MAP Linkmap file 
.LOD Load file 
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In the following examples, two special command characters are used: semicolon (;) 
and comma (,). Using a semicolon (;) followed immediately by a carriage return at 
any time after the first filename in a command line selects the default responses to 
the remaining prompts. The comma (,) separates responses to successive prompts. 


Examples: 


LINKER <filename>.SRC; 
= Uses <filename> with extension SRC. 
- Generates defaults for the linkmap and load files as indicated above. 


LINKER <filename>; 
= Uses <filename> with default extension CTL. 
- Generates defaults for the linkmap and load files as indicated above. 


LINKER <filename>,<newname>; 
- Uses <filename> with default extension CTL. 
- Generates linkmap file <newname>.MAP and load file <newname>.LOD. 


LINKER <filename>,<newname> 
- Uses <filename> with default extension CTL. 
- Generates linkmap file <newname>.MAP and prompts for the load file name. 


G.2.5 Testing the Macro Assembler 


@ Hard-Disk Systems 


1) Copy the FFT.ASM test file from the backup diskette onto the hard disk 
using the MS/PC-DOS COPY utility: 


COPY A:FFT.ASM E:*.*/V <CR> 


2) Execute the Macro Assembler using FFT.ASM as the source file. By 
entering: 


XASM FFT; <CR> 


in response to the system prompt, the Assembler generates the default 
object file FFT. MPO and default listing file FFT.LST. 


3) Compare the listing and object files just created to those on the backup 
diskette: 


- On MS-DOS, use the FILCOM utility to make the comparison: 


FILCOM FFT.MPO A:FFT.MPO <CR> 
FILCOM FFT.LST A:FFT.LST <CR> 


The contents of each file can be viewed with the TYPE utility. 


- On PC-DOS, use the TYPE utility to show the contents of the two 
files and to visually check the contents for verification: 


TYPE FFT.MPO <CR> 
TYPE A:FFT.MPO <CR> 


TYPE FPT LST <CR> 
TYPE A:FFT.LST <CR> 


Only lines containing dates or times should differ. 
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ee Floppy- Drive Systems: 
1) Insert the backup diskette into the default floppy drive. 


2) Execute the Macro Assembler using FFT.ASM as the source test file. It 
is important to use a different name for the object and listing files. Other- 
wise, the Assembler will write over these files on the backup diskette, and 
there will be no correct files with which to compare the created files. By 
entering: 


XASM FFT,MYFFT; <CR> 


in response to the system prompt, the Assembler generates object file 
MYFFT.MPO and listing file MYFFT.LST. 


3) Compare the listing and object files just created to those shipped on the 
backup diskette: 


- On MS-DOS, use the FILCOM utility to make the comparison: 


FILCOM FFT.MPO MYFFT.MPO <CR> 
FILCOM FFT.LST MYFFT.LST <CR> 


The contents of each file can be viewed with the TYPE utility. 


- On PC-DOS, use the TYPE utility to show the contents of the two 
files and to visually check the contents for verification: 


TYPE REC MPO. <CRS 
TYPE MYFFT.MPO <CR> 


TYPE FFE GST) <CR> 
TYPE MYFFT.LST <CR> 


Only lines containing dates or times should differ. 


Note: 


The files TEST1.ASM and TEST2.ASM, contained in the Linker portion of the 
diskette, can also be used to test the Macro Assembler. 


G.2.6 Testing the Link Editor 
a Hard-Disk Systems 


1) Copy the LNKTST.CTL, TST1.MPO, and TST2.MPO files from the backup 
diskette onto the hard disk using the MS/PC-DOS COPY utility: 


COPY A:LNKTST.CTL E:*.*/V <CR> 
COPY. A: TST4.MPO. EB: *.*/V> ¢<CR> 

2) Execute the Link Editor using LNKTST.CTL as the control file. By entering: 
LINKER LNKTST; <CR> 


in response to the system prompt, the Linker generates the default linkmap 
file LNKTST.MAP and default load file LNKTST.LOD. 


3) Compare the map and load files just created to those on the backup 
diskette: 
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~ On MS-DOS, use the FILCOM utility to make the comparison: 


FILCOM LNKTST.MAP A:LNKTST.MAP <CR> 
FILCOM LNKTST.LOD A:LNKTST.LOD <CR> 


The contents of each file can be viewed with the TYPE utility. 


- On PC-DOS, use the TYPE utility to show the contents of the two 


files and to visually check the contents for verification: 


TYPE LNKTST.MAP <CR> 
TYPE A:LNKTST.MAP <CR> 


TYPE LNEVST.LOD sCR 
TYPE A:LNKTST.LOD <CR> 


Only lines containing dates or times should differ. 


Floppy- Drive Systems: 


1) 
2) 


3) 


Insert the backup diskette into the default floppy drive. 


Execute the Link Editor using LNKTST.CTL as the control file. It is 
important to use a different name for the map and load files. Otherwise, 
the Linker will write over these files on the backup diskette, and there will 
be no correct files with which to compare the created files. By entering: 


LINKER LNKTST,MYLNK; <CR> 


in response to the system prompt, the Linker generates the linkmap file 
MYLNK.MAP and load file MYLNK.LOD. 


Compare the map and load files just created to those shipped on the 
backup diskette: 


- On MS-DOS, use the FILCOM utility to make the comparison: 


FILCOM LNKTST.MAP MYLNK.MAP <CR> 
FILCOM LNKTST.LOD MYLNK.LOD <CR> 


The contents of each file can be viewed with the TYPE utility. 


- On PC-DOS, use the TYPE utility to show the contents of the two 
files and to visually check the contents for verification: 


TYPE LNKTST.MAP <CR> 
TYPE MYLNK.MAP <CR> 


TYPE LNKTST.LOD <CR> 
TYPE MYLNK.LOD <CR> 


Only lines containing dates or times should differ. 
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Accumulator with Rounding 
ressed 4-157 
ZALS 
Zero Accumulator, Load Low Accumula- 
tor with Sign- Extension 
Suppressed 4-158 


ALABAMA: Huntsville (205) 837-7530. 


ARIZONA: Phoenix (602) 995-1007; 
Tucson (602) 624-3276. 


CALIFORNIA: Irvine (714) 660-8187; 
Sacramento (916) 929-1521; 

San Diego (619) 278-9601; 

Santa Clara (408) 980- 9000; 
Torrance (213) 217-701 

Woodland Hills (818) 704-7759. 


COLORADO: Aurora (303) 368-8000. 
CONNECTICUT: Wallingford (203) 269-0074. 


FLORIDA: Ft. Lauderdale (305) 973-8502; 
Maitland (305) 660-4600; Tampa (813) 870-6420. 


GEORGIA: Norcross (404) 662-7900. 
ILLINOIS: Arlington Heights (312) 640-2925. 


INDIANA: Ft. Wayne (219) 424-5174; 
Indianapolis (317) 248-8555. 


IOWA: Cedar Rapids (319) 395-9550. 
MARYLAND: Baltimore (301) 944-8600. 
MASSACHUSETTS: Waltham (617) 895-9100. 


MICHIGAN: Farmington Hills (313) 553-1500; 
Grand Rapids (616) 957-4200. 


MINNESOTA: Eden Prairie (612) 828-9300. 


MISSOURI: Kansas Cit i (816) 523-2500; 
St. Louis (314) 569-76 


NEW JERSEY: Iselin (201) 750-1050. 
NEW MEXICO: Albuquerque (505) 345-2555. 


NEW YORK: East Syracuse (315) 463-9291; 
Endicott (607) 754-3900; Melville (516) 454-6600; 
Pittsford (716) 385-6770; 

Poughkeepsie (914) 473-2900. 


NORTH CAROLINA: Charlotte (704) 527-0930; 
Raleigh (919) 876-2725. 


OHIO: Beachwood (216) 464-6100; 
Dayton (513) 258-3877. 


OREGON: Beaverton (503) 643-6758. 


PENNSYLVANIA: Ft. Washington (215) 643-6450; 
Coraopolis (412) 771-8550. 


PUERTO RICO: Hato Rey (809) 753-8700 


TEXAS: Austin (512) 250-7655; 
Houston (713) 778-6592; Richardson (214) 680-5082; 
San Antonio (512) 496-1779. 


UTAH: Murray (801) 266-8972. 

VIRGINIA: Fairfax (703) 849-1400. 
WASHINGTON: Redmond (206) 881-3080. 
WISCONSIN: Brookfield (414) 785-7140. 


CANADA: Nepean, Ontario (613) 726-1970; 
Richmond Hill, Ontario (416) 884-9181; 
St. Laurent, Quebec (514) 335-8392. 


TI Regional 
Technology Centers 


CALIFORNIA: Irvine (714) 660-8140, 
Santa Clara (408) 748-2220. 


GEORGIA: Norcross (404) 662-7945. 
ILLINOIS: Arlington Heights (312) 640-2909. 
MASSACHUSETTS: Waltham (617) 895-9197. 
TEXAS: Richardson (214) 680-5066. 
CANADA: Nepean, Ontario (613) 726-1970 


Customer 
Response Center 


TOLL FREE: (800) 232-3200 


OUTSIDE USA: (214) 995-6611 
(8:00 a.m. — 5:00 p.m. CST) 


TI Sales Offices} TI Distributors 


LF peed ca: DISTRIBUTORS IN 


Arrow Electronics 

Diplomat Electronics 

General Radio Supply Company 
Graham Electronics 

Hall-Mark Electronics 

Kierulff Electronics 

Marshall Industries 

Milgray Electronics 

Newark Electronics 

Time Electronics 

R.V. Weatherford Co. 

Wyle Laboratories 

Zeus Component, Inc. (Military) 


Tl AUTHORIZED DISTRIBUTORS IN 
CANADA 
Arrow Electronics Canada 
Future Electronics 


Tl AUTHORIZED DISTRIBUTORS IN 
U 


SA 
—OBSOLETE PRODUCT ONLY— 
Rochester Electronics, Inc. 
Newburyport, Massachusetts 
(617) 462-9332 


ALABAMA: Arrow (205) 837-6955; 
Hall-Mark (205) 837-8700; Kierulff (205) 883-6070; 
Marshall (205) 881-9235. 


ARIZONA: Arrow (602) 968-4800; 
Hall-Mark (602) 437-1200; Kierulff (602) 437-0750; 
Marshall (602) 968-6181; Wyle (602) 866-2888. 


CALIFORNIA: Los An ariel pa County: 
Arrow (818) 701-7500, (714) 838-542 
Hall-Mark (818) 716-7300, (714) 669- 4700, 


(213) 217-8400; Kierulff (213) 725-0325, (714) 731-5711, 


(714) 220-6300; Marshall (818) 407-0101, 

(818) 442-7204, (714) 660-0951; 

R.V. Weatherford (714) 966-1447, (213) 849-3451, 
Wyle (213) 322-8100, (818) 880-9001, (714) 863-9953; 
Zeus (714) 632-6880; 

Sacramento: Arrow (916) 925-7456; 

Hall-Mark (916) 722-8600; Marshall (916) 635-9700; 
Wyle (916) 638-5282; 

San Diego: Arrow (619) 565-4800; 

Hall-Mark (619) 268-1201; Kierulff (619) 278-2112; 
Marshall (619) 578-9600; ‘Wyle (619) 565-9171; 

San Francisco wed Area: Arrow (408 745-6600; 
(415) 487-4600; Hall-Mark (408) 946-0900; 

Kierulff (408) 971-2600; Marshall (408) 943- 4600; 
Wyle (408) 727-2500; Zeus (408) 998-5121. 


COLORADO: Arrow (303) 696-1111; 
Hall-Mark (303) 790-1662; Kierulff (303) 790-4444; 
Wyle (303) 457-9953. 


CONNECTICUT: Arrow (203) 265-7741; 

Diplomat (203) 797-9674; Hall-Mark (203) 269-0100; 
Kierulff (203) 265-1115; Marshall (203) 265-3822; 
Milgray (203) 795-0714. 


FLORIDA: Ft. Lauderdale: Arrow (305) 429-8200; 
Diplomat (305) 974-8700; Hall-Mark (305) 971-9280; 
Kierulff (305) 486-4004; Marshall (305) 928-0661; 
Orlando: Arrow (305) 725-1480; 

Hall-Mark (305) 855-4020; Marshall (305) 841-1878; 
Milgray (305) 647-5747; Zeus (305) 365-3000; 
Tampa: Arrow (813) 576-8995; 

Diplomat (813) 443-4514; Hall-Mark (813) 530-4543; 
Kierulff (813) 576-1966. 


GEORGIA: Arrow (404) 449-8252; 
Hall-Mark (404) 447-8000; Kierulff (404) 447-5252; 
Marshall (404) 923-5750. 
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TEXAS 
INSTRUMENTS 


ILLINOIS: Arrow (312) 397-3440; 

Diplomat (312) 595-1000; Hall-Mark (312) 860-3800; 
Kierulff (312) 250-0500; Marshall (312) 490-0155; 
Newark (312) 784-5100. 


INDIANA: Indianapolis: Arrow (317) 243-9353; 
Graham (317) 634-8202; Hall-Mark (317) 872- 8875; 
Marshall (317) 297-0483; 

Ft. Wayne: Graham (219) 423-3422. 


IOWA: Arrow (319) 395-7230. 


KANSAS: Kansas City: Arrow (913) 541-9542; 
Hall-Mark (913) 888-4747; Marshall (913) 492-3121. 


MARYLAND: Arrow (301) 995-0003; 

Diplomat (301) 995-1226; Hall-Mark (301) 988-9800; 
Kierulff (301),636-5800; Milgray (301) 995-6169; 
Marshall (301) 840-9450; Zeus (301) 997-1118. 


MASSACHUSETTS: Arrow (617) 933-8130; 
Diplomat (617) 667-4670; Hall-Mark (617) 667-0902; 
Kierulff (617) 667-8331; Marshall (617) 272-8200; 
Time (617) 532-6200; Zeus (617) 863-8800. 


MICHIGAN: Detroit: Arrow (313) 971-8220; 
Marshall (313) 525-5850; Newark (313) 967-0600; 
Grand Rapids: Arrow (616) 243-0912. 


MINNESOTA: Arrow (612) 830-1 
Hall-Mark (612) 941-2600; Kierulft ( (612) 941-7500; 
Marshall (612) 559-2211. 


MISSOURI: St. Louis: Arrow (314) 567-6888; 
Hall-Mark (314) 291-5350; Kierulff (314) 739-0855. 


NEW HAMPSHIRE: Arrow (603) 668-6968. 


NEW JERSEY: Arrow (201) 575-5300, (609) 
596-8000; Diplomat (201) 785-1830; 
General Radio (609) 964-8560; 

Hall-Mark (201) 575-4415, (609) 235-1900; 
Kierulff (201) 575-6750, (609) 235-1444; 
Marshall (201) 882-0320, (609) 234-9100; 
Milgray (609) 983-5010. 


NEW MEXICO: Arrow (505) 243-4566. 


NEW YORK: Long Island: Arrow (516) 231-1000; 
Diplomat (516) 454-6400; 

Hall-Mark (516) 737-0600; Marshall ig) 273-2053; 
Milgray (516) 420-9800; Zeus (914) 937-7400; 
Rochester: Arrow (716) 427-0300; 

Marshall (716) 235-7620; Diplomat (716) 359-4400; 
Syracuse: Arrow (315) 652- 

Marshall (607) 798-1611. 


NORTH CAROLINA: Arrow (919) 876-3132, 
(919) 725-8711; Hall-Mark (919) 872-0712; 
Kierulff (919) 872-8410; Marshall (919) 878-9882. 


OHIO: Cleveland: Arrow (216) 248-3990; 
Hall-Mark (216) 349-4632; Kierulff (216) 831-5222; 
Marshall (216) 248-1788. 

Columbus: Arrow (614) 885-8362; 

Hall-Mark (614) 888- a 

Dayton: Arrow (513) 435-5563; 

Graham (513) 435-8660; Kienitt (513) 439-0045; 
Marshall (513) 236- 8088. 


OKLAHOMA: Arrow (918) 665-7700; 
Kierulff (918) 252-7537. 


OREGON: Arrow (503) 684-1 
Kierulff (503) 641-9153; Wyle (663) 640-6000; 
Marshall (503) 644- 5050. 


PENNSYLVANIA: Arrow (412) 856-7000, 
(215) 928-1800; General Radio (215) 922-7037. 


RHODE ISLAND: Arrow (401) 431-0980 


TEXAS: Austin: Arrow (512) 835-4180; 

Hall-Mark (512) 258-8848; Kierulff (512) 835-2090; 
Marshall (512) 837-1991; Wyle (512) 834-9957; 
Dallas: Arrow (214) 380-64 64; 

Hall-Mark (214) 553-4300; Kierulff (214) 343-2400; 
Marshall (214) a 9200; ‘Wyle (214) 235-9953; 
Zeus (214) 783-7 

Houston: Arrow W713) 530-4700; 

Hall-Mark (713) 781-6100; Kierulff (713) 530-7030; 
Marshall (713) 895-9200; ‘Wyle (713) 879-9953. 


UTAH: Arrow (801) 972-0404; 

Diplomat (801) 486-4134; 

Hall-Mark (801) 268- 3779; Kierulff (801) 973-6913; 
Wyle (801) 974-9953. 


WASHINGTON: Arrow (206) 643-4800; 
Kierulff (206) 575-4420; Wyle (206) 453-8300; 
Marshall (206) 747-9100. 


WISCONSIN: Arrow (414) 792-0150; 
Hall-Mark (414) 797-7844; Kierulff (414) 784-8160; 
Marshall (414) 797-8400. 


CANADA: Calgary: Future (403) 235-5325; 
Edmonton: Future (403) 438-2858; 
Montreal: Arrow Canada (514) 735- 5511; 
Future (514) 694-7710; 

Ottawa: Arrow Canada (613) 226-6903; 
Future (613) 820-8313; 

Quebec City: Arrow Canada (418) 687-4231; 
Toronto: Arrow Canada (416) 661-0220; 
Future (416) 638-4771; 

Vancouver: Future (604) 294-1166 
Winnipeg: Future (204) 339-0554 


TI Worldwide 
Sales Offices 


ALABAMA: Huntsville: 500 Wynn Drive, Suite 514, 
Huntsville, AL 35805, (205) 837-7530. 


ARIZONA: Phoenix: 8825 N. 23rd Ave., Phoenix, 
AZ 85021, (602) 995-1007. 


CALIFORNIA: Irvine: 17891 Cartwright Rd., Irvine, 
CA 92714, (714) 660-8187; Sacramento: 1900 Point 
West Way, Suite 171, Sacramento, CA 95815, 
(916) 929-1521; San Diego: 4333 View Ridge Ave., 
Suite B., San Diego, CA 92123, (619) 278-9601; 
Santa Clara: 5353 Betsy Ross Dr., Santa Clara, CA 
95054, (408) 980-9000; Torrance: 690 Knox St., 
Torrance, CA 90502, (213) 217-7010; 

Woodland Hills: 21220 Erwin St., Woodland Hills, 
CA 91367, (818) 704-7759. 


COLORADO: Aurora: 1400 S. Potomac Ave., 
Suite 101, Aurora, CO 80012, (303) 368-8000. 


CONNECTICUT: Wallingford: 9 Barnes Industrial 
Park Rd., Barnes Industrial Park, Wallingford, 
CT 06492, (203) 269-0074. 


FLORIDA: Ft. Lauderdale: 2765 N.W. 62nd St., 
Ft. Lauderdale, FL 33309, (305) 973-8502; 
Maitland: 2601 Maitland Center Parkway, 
Maitland, FL 32751, (305) 660-4600; 

Tampa: 5010 W. Kennedy Blvd., Suite 101, 
Tampa, FL 33609, (813) 870-6420. 


GEORGIA: Norcross: 5515 Spalding Drive, Norcross, 
GA 30092, (404) 662-7900 


ILLINOIS: Arlington see 515 W. Algonquin, 
Arlington Heights, IL 60005, (312) 640-2925. 


INDIANA: Ft. Wayne: 2020 Inwood Dr., Ft. Wayne, 
IN 46815, (219) 424-5174; 

Indianapolis: 2346 S. Lynhurst, Suite J-400, 
Indianapolis, IN 46241, (317) 248-8555. 


IOWA: Cedar Rapids: 373 Collins Rd. NE, Suite 200, 
Cedar Rapids, IA 52402, (319) 395-9550. 


MARYLAND: Baltimore: 1 Rutherford Pi., 
7133 Rutherford Rd., Baltimore, MD 21207, 
(301) 944-8600. 


MASSACHUSETTS: Waltham: 504 Totten Pond Rad., 
Waltham, MA 02154, (617) 895-9100. 


MICHIGAN: Farmington Hills: 33737 W. 12 Mile Rd., 
Farmington Hillis, M! 48018, (313) 553-1500. 


MINNESOTA: Eden Prairie: 11000 W. 78th St., 
Eden Prairie, MN 55344 (612) 828-9300. 


MISSOURI: Kansas City: 8080 Ward Pkwy., Kansas 
City, MO 64114, (816) 523-2500; 

St. Louis: 11816 Borman Drive, St. Louis, 

MO 63146, (314) 569-7600. 


NEW JERSEY: Iselin: 485E U.S. Route 1 South, 
Parkway Towers, Iselin, NJ 08830 (201) 750-1050 


NEW MEXICO: Albuquerque: 2820-D Broadbent Pkwy 
NE, Albuquerque, NM 87107, (505) 345-2555. 


NEW YORK: East Syracuse: 6365 Collamer Dr., East 
Syracuse, NY 13057, (315) 463-9291; 

Endicott: 112 Nanticoke Ave., P.O. Box 618, Endicott, 
NY 13760, (607) 754-3900; Melville: 1 Huntington 
Quadrangle, Suite 3C10, P.O. Box 2936, Melville, 

NY 11747, (516) 454-6600; Pittsford: 2851 Clover St., 
Pittsford, NY 14534, (716) 385-6770; 

Poughkeepsie: 385 South Rd., Poughkeepsie, 

NY 12601, (914) 473-2900. 


NORTH CAROLINA: Charlotte: 8 Woodlawn Green, 
Woodlawn Rd., Charlotte, NC 28210, (704) 527-0930; 
rei, 2809 Highwoods Bivd., Suite 100, Raleigh, 
NC 27625, (919) 876-2725. 


OHIO: Beachwood: 23408 Commerce Park Rd., 
Beachwood, OH 44122, (216) 464-6100; 

Dayton: Bote Bidg., 4124 Linden Ave., Dayton, 
OH 45432, (513) 258-3877. 


OREGON: Beaverton: 6700 SW 105th St., Suite 110, 
Beaverton, OR 97005, (503) 643-6758. 


PENNSYLVANIA: Ft. Washington: 260 New York Dr., 
Ft. Washington, PA 19034, (215) 643-6450; 
Coraopolis: 420 Rouser Rd., 3 Airport Office Park, 
Coraopolis, PA 15108, (412) 771-8550. 


PUERTO RICO: Hato Rey: Mercantil Plaza Bidg., 
Suite 505, Hato Rey, PR 00919, (809) 753-8700. 


TEXAS: Austin: P.O. Box 2909, Austin, TX 78769, 
(512) 250-7655; Richardson: 1001 E. Campbell Rd., 
Richardson, TX 75080, 

(214) 680-5082; Houston: 9100 Southwest Frwy., 
Suite 237, Houston, TX 77036, (713) 778-6592; 
San Antonio: 1000 Central Parkway South, 

San Antonio, TX 78232, (512) 496-1779. 


UTAH: Murray: 5201 South Green SE, Suite 200, 
Murray, UT 84107, (801) 266-8972. 


VIRGINIA: Fairfax: 2750 Prosperity, Fairfax, VA 
22031, (703) 849-1400. 


WASHINGTON: Redmond: 5010 148th NE, Bidg B, 
Suite 107, Redmond, WA 98052, (206) 881-3080. 


WISCONSIN: Brookfield: 450 N. Sunny Slope, 
Suite 150, Brookfield, WI 53005, (414) 785-7140. 


CANADA: Nepean: 301 Moodie Drive, Mallorn 
Center, Nepean, Ontario, Canada, K2H9C4, 

(613) 726-1970. Richmond Hill: 280 Centre St. E., 
Richmond Hill L4C1B1, Ontario, Canada 

(416) 884-9181; St. Laurent: Ville St. Laurent Quebec, 
9460 Trans Canada Hwy., St. Laurent, Quebec, 
Canada H4S1R7, (514) 335-8392. 


ARGENTINA: Texas Instruments Argentina 
S.A.1.C.F.: Esmeralda 130, 15th Floor, 1035 Buenos 
Aires, Argentina, 1+ 394-3008. 


AUSTRALIA (& NEW ZEALAND): Texas Instruments 
Australia Ltd.: 6-10 Talavera Rd., North Ryde 
(Sydney), New South Wales, Australia 2113, 

2 + 887-1122; 5th Floor, 418 St. Kilda Road, 
Melbourne, Victoria, Australia 3004, 3 + 267-4677; 
171 Philip Highway, Elizabeth, South Australia 5112, 
8 + 255-2066. 


AUSTRIA: Texas Instruments Ges.m.b.H.: 
Industriestrabe B/16, A-2345 Brunn/Gebirge, 
2236-846210. 


BELGIUM: Texas Instruments N.V. Belgium S.A.: 
Mercure Centre, Raketstraat 100, Rue de la Fusee, 
1130 Brussels, Belgium, 2/720.80.00. 


BRAZIL: Texas Instruments Electronicos do Brasil 
Ltda.: Rua Paes Leme, 524-7 Andar Pinheiros, 05424 
Sao Paulo, Brazil, 0815-6166. 


DENMARK: Texas Instruments A/S, Mairelundvej 
46E, DK-2730 Herlev, Denmark, 2 - 91 74 00. 


FINLAND: Texas Instruments Finland OY: 
Us pg 19D 00511 Helsinki 51, Finland, (90) 
1-3133. 


FRANCE: Texas Instruments France: Headquarters 
and Prod. Plant, BP 05, 06270 Villeneuve-Loubet, 
(93) 20-01-01; Paris Office, BP 67 8-10 Avenue 
Morane-Sauinier, 78141 Velizy-Villacoublay, 

(3) 946-97-12; Lyon Sales Office, L’Oree D’Ecully, 
Batiment B, Chemin de la Forestiere, 69130 Ecully, 
(7) 833-04-40; Strasbourg Sales Office, Le Sebastopol 
3, Quai Kleber, 67055 Strasbourg Cedex, 

(88) 22-12-66; Rennes, 23-25 Rue du Puits Mauger, 
35100 Rennes, (99) 31-54-86; Toulouse Sales Office, 
Le Peripole—2, Chemin du Pigeonnier de la Cepiere, 
31100 Toulouse, (61) 44-18-19; Marseille Sales Office, 
Noilly Paradis—146 Rue Paradis, 13006 Marseille, 
(91) 37-25-30. 
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Creating useful products 
and services for you 


GERMANY (Fed. Republic of Germany): Texas 
Instruments Deutschland GmbH: Haggertystrasse 1, 
D-8050 Freising, 8161 + 80-4591; Kurfuerstendamm 
195/196, D-1000 Berlin 15, 30 + 882-7365; Ill, Hagen 
43/Kibbelstrasse, .19, D-4300 Essen, 201-24250; 
Frankfurter Allee 6-8, D-6236 Eschborm 1, 
06196 + 8070; Hamburgerstrasse 11, D-2000 Hamburg 
76, 040 + 220-1154, Kirchhorsterstrasse 2, D-3000 
Hannover 51, 511+648021; Maybachstrabe 11, 
D-7302 Ostfildern 2-Nelingen, 711+547001; 
Mixikoring 19, D-2000 Hamburg 60, 40 +637 + 0061; 
Postfach 1309, Roonstrasse 16, D-5400 Koblenz, 

261 + 35044. 


HONG KONG (+ PEOPLES REPUBLIC OF CHINA): - 
Texas Instruments Asia Ltd., 8th Floor, World 
Shipping Ctr., Harbour City, 7 Canton Rd., Kowloon, 
Hong Kong, 3 + 722-1223. 


IRELAND: Texas Instruments (ireland) Limited: 
mpi: Rd., Stillorgan, County Dublin, Eire, 
1 831311. 


ITALY: Texas Instruments Semiconduttori Italia Spa: 
Viale Delle Scienze, 1, 02015 Cittaducale (Rieti), 
Italy, 746 694.1; Via Salaria KM 24 (Palazzo Cosma), 
Monterotondo Scalo (Rome), Italy, 6 + 9003241; Viale 
Europa, 38-44, 20093 Cologno Monzese (Milano), 

2 2532541; Corso Svizzera, 185, 10100 Torino, Italy, 
pe ins Via J. Barozzi 6, 40100 Bologna, Italy, 51 

a; 


JAPAN: Texas Instruments Asia Ltd.: 4F Aoyama 
Fuji Bldg., 6-12, Kita Aoyama 3-Chome, Minato-ku, 
Tokyo, Japan 107, 3-498-2111; Osaka Branch, 5F, 
Nissho Iwai Bidg., 30 Imabashi 3- Chome, ___. 
Higashi-ku, Osaka, Japan 541, 06-204-1881; Nagoya 
Branch, 7F Daini Toyota West Bidg., 10-27, Meieki 
4-Chome, Nakamura-ku Nagoya, Japan 

450, 52-583-8691. 


KOREA: Texas Instruments Supply Co.: 3rd Floor, 
Samon Bidg., Yuksam-Dong, Gangnam-ku, 
135 Seoul, Korea, 2+ 462-8001. 


MEXICO: Texas Instruments de Mexico S.A.: Mexico 
City, AV Reforma No. 450 — 10th Floor, Mexico, 
D.F., 06600, 5+ 514-3003. 


MIDDLE EAST: Texas Instruments: No. 13, 1st Floor 
Mannai Bidg., Diplomatic Area, P.O. Box 26335, 
Manama Bahrain, Arabian Gulf, 973 + 274681. 


NETHERLANDS: Texas Instruments Holland B.V., 
P.O. Box 12995, (Bullewijk) 1100 CB Amsterdam, 
Zuid-Oost, Holland 20+ 5602911. 


NORWAY: Texas Instruments Norway A/S: PB106, 
Refstad 131, Oslo 1, Norway, (2) 155090. 


PHILIPPINES: Texas Instruments Asia Ltd.: 14th 
Floor, Ba- Lepanto Big. 8747 Paseo de Roxas, 
Makati, Metro Manila, Philippines, 2+ 8188987. 


PORTUGAL: Texas Instruments Equipamento 
Electronico (Portugal), Lda.: Rua Eng. Frederico 
Ulrich, 2650 Moreira Da Maia, 4470 Maia, Portugal, 
2-948-1003. 


SINGAPORE (+ INDIA, INDONESIA, MALAYSIA, 
THAILAND): Texas Instruments Asia Ltd.: 12 Lorong 
Bakar Batu, Unit 01-02, Kolam Ayer Industrial Estate, 
Republic of Singapore, 747-2255. 


SPAIN: Texas Instruments Espana, S.A.: C/Jose 
Lazaro Galdiano No. 6, Madrid 16, 1/458.14.58. 


SWEDEN: Texas Instruments International Trade 
Corporation (Sverigefilialen): Box 39103, 10054 
Stockholm, Sweden, 8 - 235480. 


SWITZERLAND: Texas Instruments, Inc., Reidstrasse 
6, CH-8953 Dietikon (Zuerich) Switzerland, 
1-740 2220. 


TAIWAN: Texas Instruments Supply, Co.: Room 903, 
205 Tun Hwan Rd., 71 Sung-Kiang Road, Taipei, 
Taiwan, Republic of China, 2 + 521-9321. 


UNITED KINGDOM: Texas Instruments Limited: 
Manton Lane, Bedford, MK41 7PA, England, 0234 
67466; St. James House, Wellington Road North, 
Stockport, SK4 2RT, England, 61 + 442-7162. 
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Reader Response Card May 1986 


TMS320C25 User’s Guide 


Please use this form to communicate your comments about this document, its 
organization and subject matter, for the purpose of improving technical documen- 
tation. 


1) What do you feel are the best features of this document? 


2) How does this document meet your digital signal processing needs? 


3) Do you find the organization of this document easy to follow? If not, why? 


4) What additions do you think would enhance the structure and subject matter? 


5) What deletions could be made without affecting overall usefulness? 
6) Is there any incorrect or misleading information? 


7) How would you improve this document? 


If you would like a reply, please give your name and address below. 


Name 

Company Title 
Address 

City/State/Zip Telephone 


Thank you for your cooperation. 
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Instruction Set Summary 


Mnemonic Description # Words __ Instruction Bit Code 


ae ST EEE EE 


Absolute value of accumu- 
lator 

Add to accumulator with 
shift 

Add to accumulator with 
carry 

Add to high accumulator 
Add to accumulator 

short immediate 

Add to low accumulator 
with sign-extension 
suppressed 

Add to accumulator with 
shift specified by T register 
Add to accumulator long 
immediate with shift 

Add to auxiliary register 
short immediate 

AND with accumulator 
AND immediate with accu- 
mulator with shift 

Add P register to accumu- 
lator 

Branch unconditionally 
Branch to address specified 
by accumulator 

Branch on auxiliary register 
not zero 

Branch if TC bit # O 
Branch if TC bit = 0 
Branch on carry 

Branch if accumulator > 0 
Branch if accumulator > 0 
Test bit 

Test bit specified by T 
register 

Branch on I/O status = 0 
Branch if accumulator < 0 
Block move from data mem- 
ory to data memory 

Block move from program 
memory to data memory 
Branch if accumulator < 0 
Branch on no carry 

Branch if no overflow 
Branch if accumulator # O 
Branch on overflow 
Branch if accumulator = 0 
Call subroutine indirect 
Call subroutine 
Complement accumulator 
Compare auxiliary register 
with auxiliary register ARO 
Configure block as data 
memory 

Configure block as program 
memory 

Disable interrupt 

Data move in data memory 
Enable interrupt 

Format serial port registers 
Idle until interrupt 

Input data from port 

Load accumulator with 
Load accumulator imme- 
diate short 

Load accumulator with 
shift specified by T register 
Load accumulator long 
immediate with shift 

Load auxiliary register 
Load auxiliary register 
immediate short 

Load auxiliary register 
pointer 

Load data memory page 
pointer 

Load data memory page 
pointer immediate 

Load high P register 

Load status register STO 
Load status register ST1 
Load auxiliary register 

long immediate 

Load T register 


m= MDM NNN 


mB MNP NMNMNM NN NPY a) NON bh 


— 


— 


ee ee 


110011100001101 1 
0000+S—+k—- D 
01000011 I—D 


01001000lk—D 
+3-001 1 090——K——— 


01001001 k—D 


01001010k—D 
1101«S—~+0000001 0 
01111110-—K 


01-0011 16 }— Db —— 
1101+S—+00000100 


1100111000010101 


itp 


1 
1000100101 


pS SS 6S Bie oe) gs 
2410010 1=-——_)D-—— 
11111 


1 
4 
101<4——D 
100010011 1 
10010100 C 


1100111000000100 
1100111000000101 
0011100000000 1 


0110 1<—D—— 
111000000000 
11100000111FO 
111000011111 
0<—PA+|<—— D—— 
10+S —+|<— D—— 


001010-—K——+ 


11 
0101 
1100 
1100 
1100 
100 
00 
11 


01000010 l-+— D——— 
1101+S—+00000001 


00110-R-I+— D—— 
11000+R--i-— K 


0101010110001—R— 
01010010 l+~— D—— 
1100100+-——K 
01010014 -— 0-—— 
01010000 I+— D——> 
01010001 I+—D 
11010-R+00000000 


00111100 I+— D——~ 


Mnemonic 


LTD 


LTP 
LTS 


MAC 
MACD 


MAR 
MPY 


MPYA 


MPYK 
MPYS 


MPYU 
NEG 
NOP 


instruction Set Summary (Continued) 


Description 


SE 
1 


LTA 


Load T register and accu- 
mulate previous product 
Load T register, accumulate 
previous product, and 
move data 

Load T register and store 
P register in accumulator 
Load T register and subtract 
previous product 

Multiply and accumulate 
Multiply and accumulate 
with data move 

Modify auxiliary register 
Multiply (with T register, 
store product in P register) 
Multiply and accumulate 
previous product 

Multiply immediate 
Multiply and subtract 
previous product 

Multiply unsigned 

Negate accumulator 

No operation 


NORM Normalize contents of accu- 


umulator 

OR with accumulator 

OR immediate with accu- 
mulator with shift 
Output data to port 

Load accumulator with 

P register 

Pop top of stack to low 
accumulator 

Pop top of stack to data 
memory 

Push data memory value 
onto stack 

Push low accumulator 
onto stack 

Reset carry bit 

Return from subroutine 
Reset serial port frame 
synchronization mode 
Reset hold mode 

Rotate accumulator left 
Rotate accumulator right 
Reset overflow mode 
Repeat instruction as speci- 
fied by data memory value 
Repeat instruction as speci- 
fied by immediate value 
Reset sign-extension mode 
Reset test/control flag 
Reset serial port transmit 
mode 

Reset external flag 

Store high accumulator 
with shift 

Store low accumulator 
with shift 

Store auxiliary register 
Subtract from accumulator 
long immediate with shift 
Subtract from auxiliary 
register short immediate 
Set carry bit 

Shift accumulator left 
Shift accumulator right 
Set serial port frame 
synchronization mode 
Set hold mode 

Set overflow mode 
Subtract P register from 
accumulator 

Store high P register 
Store low P register 

Set P register output 
shift mode 

Square and accumulate 
Square and subtract 
previous product 

Store status register STO 
Store status register ST1 
Set sign-extension mode 
Set test/control flag 


# Words 


FEDCBA987654321 0 


Instruction Bit Code 


00111101 I+—D 
0G 144 oD 


00111110 il D—— 
010110114 l— D—~ 


01011101 I~— D—+ 
01011100 l-— D—— 


64 01.0101--—— D——— 
00111000 k— D——— 


001110101-— D——+ 


oS 


0017 71.01 ti-— 0———— 


1 -— D— 
00010001 1 
100000000 


ee oe ee 
—_— — = 2 
-OoO-—- 


4304 i=) 
+S—~+0000010 1 


> 


1110-PA+i— D 
1100111000010100 


1100111000011101 
01111010lk—D 
01010100 I+—D 
1100111000011100 
00111000110000 


11 
1100111000100110 
1100111000110110 
11001 
11001 
11001 
11001 
01 1 


LLO00TO1I=—— 
1100111000000110 
1100111000110010 
1100111000100000 


1100111000001100 
01101+X~-k— D 


01100<X--i<— D——> 


01110<+R-I+— D 
1101+S—+0000001 1 


64-711 114.13——K 


11100001 


11 
11 
11 
11 11100011 


Instruction Set Summary (Concluded) 


Mnemonic Description # Words Instruction Bit Code 


Sa ee FEDCBA987654321 0 


Set serial port transmit 1100111000100001 
mode 

Subtract from accumulator 
with shift 

Subtract from accumulator 
with borrow 

Conditional subtract 
Subtract from high 
accumulator 

Subtract from accumulator 
short immediate 

Subtract from low 
accumulator with sign- 
extension suppressed 
Subtract from accumulator 
with shift specified by 


0001+S —+l-—— D——> 
91001 + 1442-—=)D-— 


016001 114-———0——+ 
0:4 000100 1-—D——> 


£1.001 1 6338s 5-——— 
01000104240 -——e 


01000110I*+——D 


T register 

Set external flag 1 

Table read 05744-— p———> 
0 


000001101 


+307 =D 


1000011110 


Table write 

Software interrupt 
Exclusive-OR with 
accumulator 

Exclusive-OR immediate 
with accumulator with 
shift 

Zero accumulator 

Zero low accumulator and 
load high accumulator 
Zero low accumulator and 
load high accumulator with 
rounding 

Zero accumulator and load 
low accumulator with 
sign-extension suppressed 


Assembler Directives (Concluded) 


LOAD (Force Load): Defines symbols for other programs. 
[<label>] LOAD <symbol>[,<symbol>] [<comment>] 


MLIB (Define MACRO Library): Specifies the library containing 
macro definitions. 
[<label>] MLIB '<pathname>’ [<comment>] 


1100101000000000 
01000000 I-——_D 


014 14.1:014 1253-0-— > 


01000001 +——)D——+ 


OPTION (Output Options): Selects several options for the 
assembler listing output. 
[<label>] OPTION <option list> [<comment>] 


PAGE (Eject Page): Continues source listing on new page. 
[<label>] PAGE [<comment>] 


PEND (Program Segment End): Terminates definition of a block 
of program-relocatable code. 
[<label>] PEND [<comment>] 


PSEG (Program Segment): Defines succeeding locations as 
program-relocatable. 
[<label>] PSEG [<comment>] 


REF (External Reference): Provides access to symbols defined 
in other programs. 
[<label>] REF <symbol>[,<symbol>] [<comment>] 


RORG (Relocatable Origin): Defines succeeding locations as 
program-relocatable and initializes location counter. 
[<label>] RORG [[<exp>] /<comment>/] 


SREF (Secondary External Reference): Provides secondary 
access to symbols defined in other programs. 
[<label>] SREF <symbol>[,<symbol>] [<comment>] 


TEXT (Initialize Text): Places a character string in successive 
program memory words. 
[<label>] TEXT [-]’<string>’ [<comment>] 


TITL (Page Title): Supplies source listing page titles. 
[<label>] TITL ’<string>’ [<comment>] 


UNL (Stop Source Listing): Halts source listing output until the 
occurrence of a LIST directive. 
[<label>] UNL [<comment>] 


XEND (independent Segment End): Terminates definition of 
an independently stored program segment, definedby EXEC. 
[<label>] XEND [<comment>] 


TMS320C25 
DIGITAL SIGNAL PROCESSOR 
Programmer’s Reference Card 


Ti Customer Response Center (CRC) Hotline Number 
For help with the TMS320C25, call 1-800-232-3200. 


Symbols for Instruction Set Summary 


LJ ee. eee 


4-bit field specifying a bit code 
2-bit field specifying compare mode 
Data memory address field 

Format status bit 

Addressing mode bit 


‘Immediate operand field 

Port address (PAO through PA15 are predefined assem- 
bler symbols equal to 0 through 15, respectively. ) 

2-bit field specifying P register output shift code 

3-bit operand field specifying auxiliary register 

4-bit left-shift code 

3-bit accumulator left-shift field 


Assembler Directives 


AORG (Absolute Origin): Defines succeeding locations as 
absolute and places a value in the location counter. 
[<label>] AORG [<exp> /<comment>/] 


BES (Block Ending with Symbol): Advances location counter 
and assigns a label the value of location following block. 
[<label>] BES <exp> [<comment>] 


BSS (Block Starting with Symbol): Advances location counter 
and assigns a label the value of location of first word in block. 
[<label>] BSS <exp> [<comment>] 


CEND (Common Segment End): Terminates definition of a 
block of common-relocatable code. 
[<label>] CEND [<comment>] 


COPY (Copy Source File): Causes source statements to be read 
from a different file. 
[<label>] COPY <file-name> [<comment>] 


CSEG (Common Segment): Defines succeeding locations as 
common-relocatable. 
[<label>] CSEG ['<string>’ /<comment>/] 


DATA (Initialize Word): Places values in successive program 
memory words. 
[<label>] DATA <exp>[,<exp>] [<comment>] 


DEF (External Definition): Defines symbols for other programs. 
[<label>] DEF <symbol>[,<symbol>] [<comment>] 


DEND (Data Segment End): Terminates definition of a block 
of data-relocatable code. 
[<label>] DEND [<comment>] 


DORG (Dummy Origin): Defines succeeding locations as a 
dummy block. 
[<label>] DORG <exp> [<comment>] 


DSEG (Data Segment): Defines succeeding locations as data- 
relocatable. 
[<label>] DSEG [<comment>] 


END (Program End): Terminates the assembly. 
[<label>] END [<symbol>/<comment/] 


EQU (Define Assembly-Time Constant): Assigns symbol value. 
[<label>] EQU <exp> [<comment>] 


EXEC (Independent Program Segment): Defines independently 
stored program segment and loads location counter. 
[<label>] EXEC <pma> [<comment>] 


IDT (Program Identifier): Names the object module produced. 
[<label>] IDT ‘<string>’ [<comment>] 


LIST (Restart Source Listing): Resumes source listing. 
[<label>] LIST [<comment>] 
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